@nklisch/pi-enhanced 0.1.0

package/node_modules/@nklisch/pi-plugins/dist/application/native-control-registry.d.ts

@@ -0,0 +1,899 @@
+import { z } from "zod";
+import "../domain/content-manifest.js";
+import { SafeDisplayFieldSchema } from "./native-inspection-contract.js";
+export declare const NativeControlGrammarVersionSchema: z.ZodLiteral<"plugin-control/v1">;
+export type NativeControlGrammarVersion = z.infer<typeof NativeControlGrammarVersionSchema>;
+export declare const NativeControlInputChannelSchema: z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
+    kind: z.ZodLiteral<"none">;
+}, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
+    kind: z.ZodLiteral<"provided">;
+}, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
+    kind: z.ZodLiteral<"stdin-json">;
+}, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
+    kind: z.ZodLiteral<"file-json">;
+    locator: z.ZodString;
+}, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
+    kind: z.ZodLiteral<"environment">;
+    prefix: z.ZodString;
+}, z.core.$strict>>], "kind">;
+export type NativeControlInputChannel = z.infer<typeof NativeControlInputChannelSchema>;
+export declare const NativeControlInvocationSchema: z.ZodReadonly<z.ZodObject<{
+    grammarVersion: z.ZodDefault<z.ZodLiteral<"plugin-control/v1">>;
+    output: z.ZodDefault<z.ZodEnum<{
+        human: "human";
+        json: "json";
+    }>>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    nonInteractive: z.ZodDefault<z.ZodBoolean>;
+    input: z.ZodDefault<z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
+        kind: z.ZodLiteral<"none">;
+    }, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
+        kind: z.ZodLiteral<"provided">;
+    }, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
+        kind: z.ZodLiteral<"stdin-json">;
+    }, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
+        kind: z.ZodLiteral<"file-json">;
+        locator: z.ZodString;
+    }, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
+        kind: z.ZodLiteral<"environment">;
+        prefix: z.ZodString;
+    }, z.core.$strict>>], "kind">>;
+}, z.core.$strict>>;
+export type NativeControlInvocation = z.infer<typeof NativeControlInvocationSchema>;
+export declare const NativeControlPolicyChangeSchema: z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
+    kind: z.ZodLiteral<"application">;
+    target: z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
+        kind: z.ZodLiteral<"global">;
+    }, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
+        kind: z.ZodLiteral<"scope">;
+        scope: z.ZodEnum<{
+            project: "project";
+            user: "user";
+        }>;
+    }, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
+        kind: z.ZodLiteral<"marketplace">;
+        scope: z.ZodEnum<{
+            project: "project";
+            user: "user";
+        }>;
+        registrationId: z.core.$ZodBranded<z.ZodString, "MarketplaceRegistrationId", "out">;
+    }, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
+        kind: z.ZodLiteral<"plugin">;
+        scope: z.ZodEnum<{
+            project: "project";
+            user: "user";
+        }>;
+        plugin: z.core.$ZodBranded<z.ZodString, "PluginKey", "out">;
+    }, z.core.$strict>>], "kind">;
+    mode: z.ZodEnum<{
+        automatic: "automatic";
+        inherit: "inherit";
+        manual: "manual";
+    }>;
+}, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
+    kind: z.ZodLiteral<"cadence">;
+    target: z.ZodReadonly<z.ZodObject<{
+        kind: z.ZodLiteral<"global">;
+    }, z.core.$strict>>;
+    cadence: z.ZodEnum<{
+        balanced: "balanced";
+        conservative: "conservative";
+        frequent: "frequent";
+        paused: "paused";
+    }>;
+}, z.core.$strict>>], "kind">;
+export type NativeControlPolicyChange = z.infer<typeof NativeControlPolicyChangeSchema>;
+export type NativeControlOptionKind = "flag" | "string" | "integer" | "enum" | "repeatable";
+export type NativeControlOptionDefinition = Readonly<{
+    name: `--${string}`;
+    key: string;
+    kind: NativeControlOptionKind;
+    values?: readonly string[];
+    required?: boolean;
+    equals?: boolean;
+    conflicts?: readonly string[];
+    deprecatedSince?: NativeControlGrammarVersion;
+    replacement?: string;
+    removeInMajor?: number;
+}>;
+export type NativeControlPositionalDefinition = Readonly<{
+    name: string;
+    required?: boolean;
+    repeatable?: boolean;
+}>;
+export type NativeControlCommandVisibility = "primary" | "advanced" | "protocol";
+export type NativeControlCommandDefinition = Readonly<{
+    path: readonly string[];
+    /** Controls default human help/completion only; every route remains available to automation. */
+    visibility: NativeControlCommandVisibility;
+    aliases: readonly Readonly<{
+        path: readonly string[];
+        deprecatedSince?: NativeControlGrammarVersion;
+        replacement?: string;
+        removeInMajor?: number;
+    }>[];
+    summary: z.infer<typeof SafeDisplayFieldSchema>;
+    safety: "pure" | "local-read" | "remote-read" | "mutation" | "operation-control";
+    input: "none" | "confirmation" | "configuration" | "decision";
+    request: z.ZodTypeAny;
+    /** Strict owner DTO accepted from the underlying application service. */
+    response: z.ZodTypeAny;
+    /** Strict command-specific machine DTO emitted after safe projection. */
+    projectedResponse: z.ZodTypeAny;
+    projectResponse?: (owner: unknown) => unknown;
+    positionals: readonly NativeControlPositionalDefinition[];
+    options: readonly NativeControlOptionDefinition[];
+}>;
+export declare const NativeControlCommandRegistry: Readonly<{
+    readonly presentation: Readonly<{
+        path: readonly string[];
+        /** Controls default human help/completion only; every route remains available to automation. */
+        visibility: NativeControlCommandVisibility;
+        aliases: readonly Readonly<{
+            path: readonly string[];
+            deprecatedSince?: NativeControlGrammarVersion;
+            replacement?: string;
+            removeInMajor?: number;
+        }>[];
+        summary: z.infer<typeof SafeDisplayFieldSchema>;
+        safety: "pure" | "local-read" | "remote-read" | "mutation" | "operation-control";
+        input: "none" | "confirmation" | "configuration" | "decision";
+        request: z.ZodTypeAny;
+        /** Strict owner DTO accepted from the underlying application service. */
+        response: z.ZodTypeAny;
+        /** Strict command-specific machine DTO emitted after safe projection. */
+        projectedResponse: z.ZodTypeAny;
+        projectResponse?: (owner: unknown) => unknown;
+        positionals: readonly NativeControlPositionalDefinition[];
+        options: readonly NativeControlOptionDefinition[];
+    }>;
+    readonly help: Readonly<{
+        path: readonly string[];
+        /** Controls default human help/completion only; every route remains available to automation. */
+        visibility: NativeControlCommandVisibility;
+        aliases: readonly Readonly<{
+            path: readonly string[];
+            deprecatedSince?: NativeControlGrammarVersion;
+            replacement?: string;
+            removeInMajor?: number;
+        }>[];
+        summary: z.infer<typeof SafeDisplayFieldSchema>;
+        safety: "pure" | "local-read" | "remote-read" | "mutation" | "operation-control";
+        input: "none" | "confirmation" | "configuration" | "decision";
+        request: z.ZodTypeAny;
+        /** Strict owner DTO accepted from the underlying application service. */
+        response: z.ZodTypeAny;
+        /** Strict command-specific machine DTO emitted after safe projection. */
+        projectedResponse: z.ZodTypeAny;
+        projectResponse?: (owner: unknown) => unknown;
+        positionals: readonly NativeControlPositionalDefinition[];
+        options: readonly NativeControlOptionDefinition[];
+    }>;
+    readonly grammar: Readonly<{
+        path: readonly string[];
+        /** Controls default human help/completion only; every route remains available to automation. */
+        visibility: NativeControlCommandVisibility;
+        aliases: readonly Readonly<{
+            path: readonly string[];
+            deprecatedSince?: NativeControlGrammarVersion;
+            replacement?: string;
+            removeInMajor?: number;
+        }>[];
+        summary: z.infer<typeof SafeDisplayFieldSchema>;
+        safety: "pure" | "local-read" | "remote-read" | "mutation" | "operation-control";
+        input: "none" | "confirmation" | "configuration" | "decision";
+        request: z.ZodTypeAny;
+        /** Strict owner DTO accepted from the underlying application service. */
+        response: z.ZodTypeAny;
+        /** Strict command-specific machine DTO emitted after safe projection. */
+        projectedResponse: z.ZodTypeAny;
+        projectResponse?: (owner: unknown) => unknown;
+        positionals: readonly NativeControlPositionalDefinition[];
+        options: readonly NativeControlOptionDefinition[];
+    }>;
+    readonly "marketplace.add": Readonly<{
+        path: readonly string[];
+        /** Controls default human help/completion only; every route remains available to automation. */
+        visibility: NativeControlCommandVisibility;
+        aliases: readonly Readonly<{
+            path: readonly string[];
+            deprecatedSince?: NativeControlGrammarVersion;
+            replacement?: string;
+            removeInMajor?: number;
+        }>[];
+        summary: z.infer<typeof SafeDisplayFieldSchema>;
+        safety: "pure" | "local-read" | "remote-read" | "mutation" | "operation-control";
+        input: "none" | "confirmation" | "configuration" | "decision";
+        request: z.ZodTypeAny;
+        /** Strict owner DTO accepted from the underlying application service. */
+        response: z.ZodTypeAny;
+        /** Strict command-specific machine DTO emitted after safe projection. */
+        projectedResponse: z.ZodTypeAny;
+        projectResponse?: (owner: unknown) => unknown;
+        positionals: readonly NativeControlPositionalDefinition[];
+        options: readonly NativeControlOptionDefinition[];
+    }>;
+    readonly "marketplace.remove": Readonly<{
+        path: readonly string[];
+        /** Controls default human help/completion only; every route remains available to automation. */
+        visibility: NativeControlCommandVisibility;
+        aliases: readonly Readonly<{
+            path: readonly string[];
+            deprecatedSince?: NativeControlGrammarVersion;
+            replacement?: string;
+            removeInMajor?: number;
+        }>[];
+        summary: z.infer<typeof SafeDisplayFieldSchema>;
+        safety: "pure" | "local-read" | "remote-read" | "mutation" | "operation-control";
+        input: "none" | "confirmation" | "configuration" | "decision";
+        request: z.ZodTypeAny;
+        /** Strict owner DTO accepted from the underlying application service. */
+        response: z.ZodTypeAny;
+        /** Strict command-specific machine DTO emitted after safe projection. */
+        projectedResponse: z.ZodTypeAny;
+        projectResponse?: (owner: unknown) => unknown;
+        positionals: readonly NativeControlPositionalDefinition[];
+        options: readonly NativeControlOptionDefinition[];
+    }>;
+    readonly "marketplace.list": Readonly<{
+        path: readonly string[];
+        /** Controls default human help/completion only; every route remains available to automation. */
+        visibility: NativeControlCommandVisibility;
+        aliases: readonly Readonly<{
+            path: readonly string[];
+            deprecatedSince?: NativeControlGrammarVersion;
+            replacement?: string;
+            removeInMajor?: number;
+        }>[];
+        summary: z.infer<typeof SafeDisplayFieldSchema>;
+        safety: "pure" | "local-read" | "remote-read" | "mutation" | "operation-control";
+        input: "none" | "confirmation" | "configuration" | "decision";
+        request: z.ZodTypeAny;
+        /** Strict owner DTO accepted from the underlying application service. */
+        response: z.ZodTypeAny;
+        /** Strict command-specific machine DTO emitted after safe projection. */
+        projectedResponse: z.ZodTypeAny;
+        projectResponse?: (owner: unknown) => unknown;
+        positionals: readonly NativeControlPositionalDefinition[];
+        options: readonly NativeControlOptionDefinition[];
+    }>;
+    readonly "marketplace.refresh": Readonly<{
+        path: readonly string[];
+        /** Controls default human help/completion only; every route remains available to automation. */
+        visibility: NativeControlCommandVisibility;
+        aliases: readonly Readonly<{
+            path: readonly string[];
+            deprecatedSince?: NativeControlGrammarVersion;
+            replacement?: string;
+            removeInMajor?: number;
+        }>[];
+        summary: z.infer<typeof SafeDisplayFieldSchema>;
+        safety: "pure" | "local-read" | "remote-read" | "mutation" | "operation-control";
+        input: "none" | "confirmation" | "configuration" | "decision";
+        request: z.ZodTypeAny;
+        /** Strict owner DTO accepted from the underlying application service. */
+        response: z.ZodTypeAny;
+        /** Strict command-specific machine DTO emitted after safe projection. */
+        projectedResponse: z.ZodTypeAny;
+        projectResponse?: (owner: unknown) => unknown;
+        positionals: readonly NativeControlPositionalDefinition[];
+        options: readonly NativeControlOptionDefinition[];
+    }>;
+    readonly "marketplace.adopt.preview": Readonly<{
+        path: readonly string[];
+        /** Controls default human help/completion only; every route remains available to automation. */
+        visibility: NativeControlCommandVisibility;
+        aliases: readonly Readonly<{
+            path: readonly string[];
+            deprecatedSince?: NativeControlGrammarVersion;
+            replacement?: string;
+            removeInMajor?: number;
+        }>[];
+        summary: z.infer<typeof SafeDisplayFieldSchema>;
+        safety: "pure" | "local-read" | "remote-read" | "mutation" | "operation-control";
+        input: "none" | "confirmation" | "configuration" | "decision";
+        request: z.ZodTypeAny;
+        /** Strict owner DTO accepted from the underlying application service. */
+        response: z.ZodTypeAny;
+        /** Strict command-specific machine DTO emitted after safe projection. */
+        projectedResponse: z.ZodTypeAny;
+        projectResponse?: (owner: unknown) => unknown;
+        positionals: readonly NativeControlPositionalDefinition[];
+        options: readonly NativeControlOptionDefinition[];
+    }>;
+    readonly "marketplace.adopt.import": Readonly<{
+        path: readonly string[];
+        /** Controls default human help/completion only; every route remains available to automation. */
+        visibility: NativeControlCommandVisibility;
+        aliases: readonly Readonly<{
+            path: readonly string[];
+            deprecatedSince?: NativeControlGrammarVersion;
+            replacement?: string;
+            removeInMajor?: number;
+        }>[];
+        summary: z.infer<typeof SafeDisplayFieldSchema>;
+        safety: "pure" | "local-read" | "remote-read" | "mutation" | "operation-control";
+        input: "none" | "confirmation" | "configuration" | "decision";
+        request: z.ZodTypeAny;
+        /** Strict owner DTO accepted from the underlying application service. */
+        response: z.ZodTypeAny;
+        /** Strict command-specific machine DTO emitted after safe projection. */
+        projectedResponse: z.ZodTypeAny;
+        projectResponse?: (owner: unknown) => unknown;
+        positionals: readonly NativeControlPositionalDefinition[];
+        options: readonly NativeControlOptionDefinition[];
+    }>;
+    readonly browse: Readonly<{
+        path: readonly string[];
+        /** Controls default human help/completion only; every route remains available to automation. */
+        visibility: NativeControlCommandVisibility;
+        aliases: readonly Readonly<{
+            path: readonly string[];
+            deprecatedSince?: NativeControlGrammarVersion;
+            replacement?: string;
+            removeInMajor?: number;
+        }>[];
+        summary: z.infer<typeof SafeDisplayFieldSchema>;
+        safety: "pure" | "local-read" | "remote-read" | "mutation" | "operation-control";
+        input: "none" | "confirmation" | "configuration" | "decision";
+        request: z.ZodTypeAny;
+        /** Strict owner DTO accepted from the underlying application service. */
+        response: z.ZodTypeAny;
+        /** Strict command-specific machine DTO emitted after safe projection. */
+        projectedResponse: z.ZodTypeAny;
+        projectResponse?: (owner: unknown) => unknown;
+        positionals: readonly NativeControlPositionalDefinition[];
+        options: readonly NativeControlOptionDefinition[];
+    }>;
+    readonly "inspection.list": Readonly<{
+        path: readonly string[];
+        /** Controls default human help/completion only; every route remains available to automation. */
+        visibility: NativeControlCommandVisibility;
+        aliases: readonly Readonly<{
+            path: readonly string[];
+            deprecatedSince?: NativeControlGrammarVersion;
+            replacement?: string;
+            removeInMajor?: number;
+        }>[];
+        summary: z.infer<typeof SafeDisplayFieldSchema>;
+        safety: "pure" | "local-read" | "remote-read" | "mutation" | "operation-control";
+        input: "none" | "confirmation" | "configuration" | "decision";
+        request: z.ZodTypeAny;
+        /** Strict owner DTO accepted from the underlying application service. */
+        response: z.ZodTypeAny;
+        /** Strict command-specific machine DTO emitted after safe projection. */
+        projectedResponse: z.ZodTypeAny;
+        projectResponse?: (owner: unknown) => unknown;
+        positionals: readonly NativeControlPositionalDefinition[];
+        options: readonly NativeControlOptionDefinition[];
+    }>;
+    readonly "inspection.show": Readonly<{
+        path: readonly string[];
+        /** Controls default human help/completion only; every route remains available to automation. */
+        visibility: NativeControlCommandVisibility;
+        aliases: readonly Readonly<{
+            path: readonly string[];
+            deprecatedSince?: NativeControlGrammarVersion;
+            replacement?: string;
+            removeInMajor?: number;
+        }>[];
+        summary: z.infer<typeof SafeDisplayFieldSchema>;
+        safety: "pure" | "local-read" | "remote-read" | "mutation" | "operation-control";
+        input: "none" | "confirmation" | "configuration" | "decision";
+        request: z.ZodTypeAny;
+        /** Strict owner DTO accepted from the underlying application service. */
+        response: z.ZodTypeAny;
+        /** Strict command-specific machine DTO emitted after safe projection. */
+        projectedResponse: z.ZodTypeAny;
+        projectResponse?: (owner: unknown) => unknown;
+        positionals: readonly NativeControlPositionalDefinition[];
+        options: readonly NativeControlOptionDefinition[];
+    }>;
+    readonly "inspection.diagnose": Readonly<{
+        path: readonly string[];
+        /** Controls default human help/completion only; every route remains available to automation. */
+        visibility: NativeControlCommandVisibility;
+        aliases: readonly Readonly<{
+            path: readonly string[];
+            deprecatedSince?: NativeControlGrammarVersion;
+            replacement?: string;
+            removeInMajor?: number;
+        }>[];
+        summary: z.infer<typeof SafeDisplayFieldSchema>;
+        safety: "pure" | "local-read" | "remote-read" | "mutation" | "operation-control";
+        input: "none" | "confirmation" | "configuration" | "decision";
+        request: z.ZodTypeAny;
+        /** Strict owner DTO accepted from the underlying application service. */
+        response: z.ZodTypeAny;
+        /** Strict command-specific machine DTO emitted after safe projection. */
+        projectedResponse: z.ZodTypeAny;
+        projectResponse?: (owner: unknown) => unknown;
+        positionals: readonly NativeControlPositionalDefinition[];
+        options: readonly NativeControlOptionDefinition[];
+    }>;
+    readonly "install.open": Readonly<{
+        path: readonly string[];
+        /** Controls default human help/completion only; every route remains available to automation. */
+        visibility: NativeControlCommandVisibility;
+        aliases: readonly Readonly<{
+            path: readonly string[];
+            deprecatedSince?: NativeControlGrammarVersion;
+            replacement?: string;
+            removeInMajor?: number;
+        }>[];
+        summary: z.infer<typeof SafeDisplayFieldSchema>;
+        safety: "pure" | "local-read" | "remote-read" | "mutation" | "operation-control";
+        input: "none" | "confirmation" | "configuration" | "decision";
+        request: z.ZodTypeAny;
+        /** Strict owner DTO accepted from the underlying application service. */
+        response: z.ZodTypeAny;
+        /** Strict command-specific machine DTO emitted after safe projection. */
+        projectedResponse: z.ZodTypeAny;
+        projectResponse?: (owner: unknown) => unknown;
+        positionals: readonly NativeControlPositionalDefinition[];
+        options: readonly NativeControlOptionDefinition[];
+    }>;
+    readonly "install.apply": Readonly<{
+        path: readonly string[];
+        /** Controls default human help/completion only; every route remains available to automation. */
+        visibility: NativeControlCommandVisibility;
+        aliases: readonly Readonly<{
+            path: readonly string[];
+            deprecatedSince?: NativeControlGrammarVersion;
+            replacement?: string;
+            removeInMajor?: number;
+        }>[];
+        summary: z.infer<typeof SafeDisplayFieldSchema>;
+        safety: "pure" | "local-read" | "remote-read" | "mutation" | "operation-control";
+        input: "none" | "confirmation" | "configuration" | "decision";
+        request: z.ZodTypeAny;
+        /** Strict owner DTO accepted from the underlying application service. */
+        response: z.ZodTypeAny;
+        /** Strict command-specific machine DTO emitted after safe projection. */
+        projectedResponse: z.ZodTypeAny;
+        projectResponse?: (owner: unknown) => unknown;
+        positionals: readonly NativeControlPositionalDefinition[];
+        options: readonly NativeControlOptionDefinition[];
+    }>;
+    readonly "install.recover": Readonly<{
+        path: readonly string[];
+        /** Controls default human help/completion only; every route remains available to automation. */
+        visibility: NativeControlCommandVisibility;
+        aliases: readonly Readonly<{
+            path: readonly string[];
+            deprecatedSince?: NativeControlGrammarVersion;
+            replacement?: string;
+            removeInMajor?: number;
+        }>[];
+        summary: z.infer<typeof SafeDisplayFieldSchema>;
+        safety: "pure" | "local-read" | "remote-read" | "mutation" | "operation-control";
+        input: "none" | "confirmation" | "configuration" | "decision";
+        request: z.ZodTypeAny;
+        /** Strict owner DTO accepted from the underlying application service. */
+        response: z.ZodTypeAny;
+        /** Strict command-specific machine DTO emitted after safe projection. */
+        projectedResponse: z.ZodTypeAny;
+        projectResponse?: (owner: unknown) => unknown;
+        positionals: readonly NativeControlPositionalDefinition[];
+        options: readonly NativeControlOptionDefinition[];
+    }>;
+    readonly "install.run": Readonly<{
+        path: readonly string[];
+        /** Controls default human help/completion only; every route remains available to automation. */
+        visibility: NativeControlCommandVisibility;
+        aliases: readonly Readonly<{
+            path: readonly string[];
+            deprecatedSince?: NativeControlGrammarVersion;
+            replacement?: string;
+            removeInMajor?: number;
+        }>[];
+        summary: z.infer<typeof SafeDisplayFieldSchema>;
+        safety: "pure" | "local-read" | "remote-read" | "mutation" | "operation-control";
+        input: "none" | "confirmation" | "configuration" | "decision";
+        request: z.ZodTypeAny;
+        /** Strict owner DTO accepted from the underlying application service. */
+        response: z.ZodTypeAny;
+        /** Strict command-specific machine DTO emitted after safe projection. */
+        projectedResponse: z.ZodTypeAny;
+        projectResponse?: (owner: unknown) => unknown;
+        positionals: readonly NativeControlPositionalDefinition[];
+        options: readonly NativeControlOptionDefinition[];
+    }>;
+    readonly "lifecycle.enable": Readonly<{
+        path: readonly string[];
+        /** Controls default human help/completion only; every route remains available to automation. */
+        visibility: NativeControlCommandVisibility;
+        aliases: readonly Readonly<{
+            path: readonly string[];
+            deprecatedSince?: NativeControlGrammarVersion;
+            replacement?: string;
+            removeInMajor?: number;
+        }>[];
+        summary: z.infer<typeof SafeDisplayFieldSchema>;
+        safety: "pure" | "local-read" | "remote-read" | "mutation" | "operation-control";
+        input: "none" | "confirmation" | "configuration" | "decision";
+        request: z.ZodTypeAny;
+        /** Strict owner DTO accepted from the underlying application service. */
+        response: z.ZodTypeAny;
+        /** Strict command-specific machine DTO emitted after safe projection. */
+        projectedResponse: z.ZodTypeAny;
+        projectResponse?: (owner: unknown) => unknown;
+        positionals: readonly NativeControlPositionalDefinition[];
+        options: readonly NativeControlOptionDefinition[];
+    }>;
+    readonly "lifecycle.disable": Readonly<{
+        path: readonly string[];
+        /** Controls default human help/completion only; every route remains available to automation. */
+        visibility: NativeControlCommandVisibility;
+        aliases: readonly Readonly<{
+            path: readonly string[];
+            deprecatedSince?: NativeControlGrammarVersion;
+            replacement?: string;
+            removeInMajor?: number;
+        }>[];
+        summary: z.infer<typeof SafeDisplayFieldSchema>;
+        safety: "pure" | "local-read" | "remote-read" | "mutation" | "operation-control";
+        input: "none" | "confirmation" | "configuration" | "decision";
+        request: z.ZodTypeAny;
+        /** Strict owner DTO accepted from the underlying application service. */
+        response: z.ZodTypeAny;
+        /** Strict command-specific machine DTO emitted after safe projection. */
+        projectedResponse: z.ZodTypeAny;
+        projectResponse?: (owner: unknown) => unknown;
+        positionals: readonly NativeControlPositionalDefinition[];
+        options: readonly NativeControlOptionDefinition[];
+    }>;
+    readonly "lifecycle.update": Readonly<{
+        path: readonly string[];
+        /** Controls default human help/completion only; every route remains available to automation. */
+        visibility: NativeControlCommandVisibility;
+        aliases: readonly Readonly<{
+            path: readonly string[];
+            deprecatedSince?: NativeControlGrammarVersion;
+            replacement?: string;
+            removeInMajor?: number;
+        }>[];
+        summary: z.infer<typeof SafeDisplayFieldSchema>;
+        safety: "pure" | "local-read" | "remote-read" | "mutation" | "operation-control";
+        input: "none" | "confirmation" | "configuration" | "decision";
+        request: z.ZodTypeAny;
+        /** Strict owner DTO accepted from the underlying application service. */
+        response: z.ZodTypeAny;
+        /** Strict command-specific machine DTO emitted after safe projection. */
+        projectedResponse: z.ZodTypeAny;
+        projectResponse?: (owner: unknown) => unknown;
+        positionals: readonly NativeControlPositionalDefinition[];
+        options: readonly NativeControlOptionDefinition[];
+    }>;
+    readonly "lifecycle.uninstall": Readonly<{
+        path: readonly string[];
+        /** Controls default human help/completion only; every route remains available to automation. */
+        visibility: NativeControlCommandVisibility;
+        aliases: readonly Readonly<{
+            path: readonly string[];
+            deprecatedSince?: NativeControlGrammarVersion;
+            replacement?: string;
+            removeInMajor?: number;
+        }>[];
+        summary: z.infer<typeof SafeDisplayFieldSchema>;
+        safety: "pure" | "local-read" | "remote-read" | "mutation" | "operation-control";
+        input: "none" | "confirmation" | "configuration" | "decision";
+        request: z.ZodTypeAny;
+        /** Strict owner DTO accepted from the underlying application service. */
+        response: z.ZodTypeAny;
+        /** Strict command-specific machine DTO emitted after safe projection. */
+        projectedResponse: z.ZodTypeAny;
+        projectResponse?: (owner: unknown) => unknown;
+        positionals: readonly NativeControlPositionalDefinition[];
+        options: readonly NativeControlOptionDefinition[];
+    }>;
+    readonly "project.sync": Readonly<{
+        path: readonly string[];
+        /** Controls default human help/completion only; every route remains available to automation. */
+        visibility: NativeControlCommandVisibility;
+        aliases: readonly Readonly<{
+            path: readonly string[];
+            deprecatedSince?: NativeControlGrammarVersion;
+            replacement?: string;
+            removeInMajor?: number;
+        }>[];
+        summary: z.infer<typeof SafeDisplayFieldSchema>;
+        safety: "pure" | "local-read" | "remote-read" | "mutation" | "operation-control";
+        input: "none" | "confirmation" | "configuration" | "decision";
+        request: z.ZodTypeAny;
+        /** Strict owner DTO accepted from the underlying application service. */
+        response: z.ZodTypeAny;
+        /** Strict command-specific machine DTO emitted after safe projection. */
+        projectedResponse: z.ZodTypeAny;
+        projectResponse?: (owner: unknown) => unknown;
+        positionals: readonly NativeControlPositionalDefinition[];
+        options: readonly NativeControlOptionDefinition[];
+    }>;
+    readonly "updates.status": Readonly<{
+        path: readonly string[];
+        /** Controls default human help/completion only; every route remains available to automation. */
+        visibility: NativeControlCommandVisibility;
+        aliases: readonly Readonly<{
+            path: readonly string[];
+            deprecatedSince?: NativeControlGrammarVersion;
+            replacement?: string;
+            removeInMajor?: number;
+        }>[];
+        summary: z.infer<typeof SafeDisplayFieldSchema>;
+        safety: "pure" | "local-read" | "remote-read" | "mutation" | "operation-control";
+        input: "none" | "confirmation" | "configuration" | "decision";
+        request: z.ZodTypeAny;
+        /** Strict owner DTO accepted from the underlying application service. */
+        response: z.ZodTypeAny;
+        /** Strict command-specific machine DTO emitted after safe projection. */
+        projectedResponse: z.ZodTypeAny;
+        projectResponse?: (owner: unknown) => unknown;
+        positionals: readonly NativeControlPositionalDefinition[];
+        options: readonly NativeControlOptionDefinition[];
+    }>;
+    readonly "updates.policy.preview": Readonly<{
+        path: readonly string[];
+        /** Controls default human help/completion only; every route remains available to automation. */
+        visibility: NativeControlCommandVisibility;
+        aliases: readonly Readonly<{
+            path: readonly string[];
+            deprecatedSince?: NativeControlGrammarVersion;
+            replacement?: string;
+            removeInMajor?: number;
+        }>[];
+        summary: z.infer<typeof SafeDisplayFieldSchema>;
+        safety: "pure" | "local-read" | "remote-read" | "mutation" | "operation-control";
+        input: "none" | "confirmation" | "configuration" | "decision";
+        request: z.ZodTypeAny;
+        /** Strict owner DTO accepted from the underlying application service. */
+        response: z.ZodTypeAny;
+        /** Strict command-specific machine DTO emitted after safe projection. */
+        projectedResponse: z.ZodTypeAny;
+        projectResponse?: (owner: unknown) => unknown;
+        positionals: readonly NativeControlPositionalDefinition[];
+        options: readonly NativeControlOptionDefinition[];
+    }>;
+    readonly "updates.policy.apply": Readonly<{
+        path: readonly string[];
+        /** Controls default human help/completion only; every route remains available to automation. */
+        visibility: NativeControlCommandVisibility;
+        aliases: readonly Readonly<{
+            path: readonly string[];
+            deprecatedSince?: NativeControlGrammarVersion;
+            replacement?: string;
+            removeInMajor?: number;
+        }>[];
+        summary: z.infer<typeof SafeDisplayFieldSchema>;
+        safety: "pure" | "local-read" | "remote-read" | "mutation" | "operation-control";
+        input: "none" | "confirmation" | "configuration" | "decision";
+        request: z.ZodTypeAny;
+        /** Strict owner DTO accepted from the underlying application service. */
+        response: z.ZodTypeAny;
+        /** Strict command-specific machine DTO emitted after safe projection. */
+        projectedResponse: z.ZodTypeAny;
+        projectResponse?: (owner: unknown) => unknown;
+        positionals: readonly NativeControlPositionalDefinition[];
+        options: readonly NativeControlOptionDefinition[];
+    }>;
+    readonly "updates.policy.set": Readonly<{
+        path: readonly string[];
+        /** Controls default human help/completion only; every route remains available to automation. */
+        visibility: NativeControlCommandVisibility;
+        aliases: readonly Readonly<{
+            path: readonly string[];
+            deprecatedSince?: NativeControlGrammarVersion;
+            replacement?: string;
+            removeInMajor?: number;
+        }>[];
+        summary: z.infer<typeof SafeDisplayFieldSchema>;
+        safety: "pure" | "local-read" | "remote-read" | "mutation" | "operation-control";
+        input: "none" | "confirmation" | "configuration" | "decision";
+        request: z.ZodTypeAny;
+        /** Strict owner DTO accepted from the underlying application service. */
+        response: z.ZodTypeAny;
+        /** Strict command-specific machine DTO emitted after safe projection. */
+        projectedResponse: z.ZodTypeAny;
+        projectResponse?: (owner: unknown) => unknown;
+        positionals: readonly NativeControlPositionalDefinition[];
+        options: readonly NativeControlOptionDefinition[];
+    }>;
+    readonly "updates.notices.list": Readonly<{
+        path: readonly string[];
+        /** Controls default human help/completion only; every route remains available to automation. */
+        visibility: NativeControlCommandVisibility;
+        aliases: readonly Readonly<{
+            path: readonly string[];
+            deprecatedSince?: NativeControlGrammarVersion;
+            replacement?: string;
+            removeInMajor?: number;
+        }>[];
+        summary: z.infer<typeof SafeDisplayFieldSchema>;
+        safety: "pure" | "local-read" | "remote-read" | "mutation" | "operation-control";
+        input: "none" | "confirmation" | "configuration" | "decision";
+        request: z.ZodTypeAny;
+        /** Strict owner DTO accepted from the underlying application service. */
+        response: z.ZodTypeAny;
+        /** Strict command-specific machine DTO emitted after safe projection. */
+        projectedResponse: z.ZodTypeAny;
+        projectResponse?: (owner: unknown) => unknown;
+        positionals: readonly NativeControlPositionalDefinition[];
+        options: readonly NativeControlOptionDefinition[];
+    }>;
+    readonly "updates.notices.acknowledge": Readonly<{
+        path: readonly string[];
+        /** Controls default human help/completion only; every route remains available to automation. */
+        visibility: NativeControlCommandVisibility;
+        aliases: readonly Readonly<{
+            path: readonly string[];
+            deprecatedSince?: NativeControlGrammarVersion;
+            replacement?: string;
+            removeInMajor?: number;
+        }>[];
+        summary: z.infer<typeof SafeDisplayFieldSchema>;
+        safety: "pure" | "local-read" | "remote-read" | "mutation" | "operation-control";
+        input: "none" | "confirmation" | "configuration" | "decision";
+        request: z.ZodTypeAny;
+        /** Strict owner DTO accepted from the underlying application service. */
+        response: z.ZodTypeAny;
+        /** Strict command-specific machine DTO emitted after safe projection. */
+        projectedResponse: z.ZodTypeAny;
+        projectResponse?: (owner: unknown) => unknown;
+        positionals: readonly NativeControlPositionalDefinition[];
+        options: readonly NativeControlOptionDefinition[];
+    }>;
+    readonly "updates.automatic.run": Readonly<{
+        path: readonly string[];
+        /** Controls default human help/completion only; every route remains available to automation. */
+        visibility: NativeControlCommandVisibility;
+        aliases: readonly Readonly<{
+            path: readonly string[];
+            deprecatedSince?: NativeControlGrammarVersion;
+            replacement?: string;
+            removeInMajor?: number;
+        }>[];
+        summary: z.infer<typeof SafeDisplayFieldSchema>;
+        safety: "pure" | "local-read" | "remote-read" | "mutation" | "operation-control";
+        input: "none" | "confirmation" | "configuration" | "decision";
+        request: z.ZodTypeAny;
+        /** Strict owner DTO accepted from the underlying application service. */
+        response: z.ZodTypeAny;
+        /** Strict command-specific machine DTO emitted after safe projection. */
+        projectedResponse: z.ZodTypeAny;
+        projectResponse?: (owner: unknown) => unknown;
+        positionals: readonly NativeControlPositionalDefinition[];
+        options: readonly NativeControlOptionDefinition[];
+    }>;
+    readonly "config.host-precedence": Readonly<{
+        path: readonly string[];
+        /** Controls default human help/completion only; every route remains available to automation. */
+        visibility: NativeControlCommandVisibility;
+        aliases: readonly Readonly<{
+            path: readonly string[];
+            deprecatedSince?: NativeControlGrammarVersion;
+            replacement?: string;
+            removeInMajor?: number;
+        }>[];
+        summary: z.infer<typeof SafeDisplayFieldSchema>;
+        safety: "pure" | "local-read" | "remote-read" | "mutation" | "operation-control";
+        input: "none" | "confirmation" | "configuration" | "decision";
+        request: z.ZodTypeAny;
+        /** Strict owner DTO accepted from the underlying application service. */
+        response: z.ZodTypeAny;
+        /** Strict command-specific machine DTO emitted after safe projection. */
+        projectedResponse: z.ZodTypeAny;
+        projectResponse?: (owner: unknown) => unknown;
+        positionals: readonly NativeControlPositionalDefinition[];
+        options: readonly NativeControlOptionDefinition[];
+    }>;
+    readonly status: Readonly<{
+        path: readonly string[];
+        /** Controls default human help/completion only; every route remains available to automation. */
+        visibility: NativeControlCommandVisibility;
+        aliases: readonly Readonly<{
+            path: readonly string[];
+            deprecatedSince?: NativeControlGrammarVersion;
+            replacement?: string;
+            removeInMajor?: number;
+        }>[];
+        summary: z.infer<typeof SafeDisplayFieldSchema>;
+        safety: "pure" | "local-read" | "remote-read" | "mutation" | "operation-control";
+        input: "none" | "confirmation" | "configuration" | "decision";
+        request: z.ZodTypeAny;
+        /** Strict owner DTO accepted from the underlying application service. */
+        response: z.ZodTypeAny;
+        /** Strict command-specific machine DTO emitted after safe projection. */
+        projectedResponse: z.ZodTypeAny;
+        projectResponse?: (owner: unknown) => unknown;
+        positionals: readonly NativeControlPositionalDefinition[];
+        options: readonly NativeControlOptionDefinition[];
+    }>;
+    readonly "operation.status": Readonly<{
+        path: readonly string[];
+        /** Controls default human help/completion only; every route remains available to automation. */
+        visibility: NativeControlCommandVisibility;
+        aliases: readonly Readonly<{
+            path: readonly string[];
+            deprecatedSince?: NativeControlGrammarVersion;
+            replacement?: string;
+            removeInMajor?: number;
+        }>[];
+        summary: z.infer<typeof SafeDisplayFieldSchema>;
+        safety: "pure" | "local-read" | "remote-read" | "mutation" | "operation-control";
+        input: "none" | "confirmation" | "configuration" | "decision";
+        request: z.ZodTypeAny;
+        /** Strict owner DTO accepted from the underlying application service. */
+        response: z.ZodTypeAny;
+        /** Strict command-specific machine DTO emitted after safe projection. */
+        projectedResponse: z.ZodTypeAny;
+        projectResponse?: (owner: unknown) => unknown;
+        positionals: readonly NativeControlPositionalDefinition[];
+        options: readonly NativeControlOptionDefinition[];
+    }>;
+    readonly "operation.cancel": Readonly<{
+        path: readonly string[];
+        /** Controls default human help/completion only; every route remains available to automation. */
+        visibility: NativeControlCommandVisibility;
+        aliases: readonly Readonly<{
+            path: readonly string[];
+            deprecatedSince?: NativeControlGrammarVersion;
+            replacement?: string;
+            removeInMajor?: number;
+        }>[];
+        summary: z.infer<typeof SafeDisplayFieldSchema>;
+        safety: "pure" | "local-read" | "remote-read" | "mutation" | "operation-control";
+        input: "none" | "confirmation" | "configuration" | "decision";
+        request: z.ZodTypeAny;
+        /** Strict owner DTO accepted from the underlying application service. */
+        response: z.ZodTypeAny;
+        /** Strict command-specific machine DTO emitted after safe projection. */
+        projectedResponse: z.ZodTypeAny;
+        projectResponse?: (owner: unknown) => unknown;
+        positionals: readonly NativeControlPositionalDefinition[];
+        options: readonly NativeControlOptionDefinition[];
+    }>;
+}>;
+export type NativeControlCommandId = keyof typeof NativeControlCommandRegistry;
+export declare const NativeControlCommandIdSchema: z.ZodEnum<{
+    browse: "browse";
+    "config.host-precedence": "config.host-precedence";
+    grammar: "grammar";
+    help: "help";
+    "inspection.diagnose": "inspection.diagnose";
+    "inspection.list": "inspection.list";
+    "inspection.show": "inspection.show";
+    "install.apply": "install.apply";
+    "install.open": "install.open";
+    "install.recover": "install.recover";
+    "install.run": "install.run";
+    "lifecycle.disable": "lifecycle.disable";
+    "lifecycle.enable": "lifecycle.enable";
+    "lifecycle.uninstall": "lifecycle.uninstall";
+    "lifecycle.update": "lifecycle.update";
+    "marketplace.add": "marketplace.add";
+    "marketplace.adopt.import": "marketplace.adopt.import";
+    "marketplace.adopt.preview": "marketplace.adopt.preview";
+    "marketplace.list": "marketplace.list";
+    "marketplace.refresh": "marketplace.refresh";
+    "marketplace.remove": "marketplace.remove";
+    "operation.cancel": "operation.cancel";
+    "operation.status": "operation.status";
+    presentation: "presentation";
+    "project.sync": "project.sync";
+    status: "status";
+    "updates.automatic.run": "updates.automatic.run";
+    "updates.notices.acknowledge": "updates.notices.acknowledge";
+    "updates.notices.list": "updates.notices.list";
+    "updates.policy.apply": "updates.policy.apply";
+    "updates.policy.preview": "updates.policy.preview";
+    "updates.policy.set": "updates.policy.set";
+    "updates.status": "updates.status";
+}>;
+export type NativeControlCommand = {
+    [K in NativeControlCommandId]: Readonly<{
+        command: K;
+        request: z.infer<(typeof NativeControlCommandRegistry)[K]["request"]>;
+        invocation: NativeControlInvocation;
+    }>;
+}[NativeControlCommandId];
+export declare const NativeControlCommandSchema: z.ZodType<NativeControlCommand>;
+export declare function nativeControlCommandIds(): readonly NativeControlCommandId[];