@unbrained/pm-cli 2026.10.12 → 2026.10.13

package/dist/core/extensions/extension-types.d.ts

@@ -25,11 +25,11 @@ export declare const EXTENSION_CAPABILITY_CONTRACT_VERSION = 2;
 export declare const EXTENSION_CAPABILITY_LEGACY_ALIASES: Readonly<Record<string, ExtensionCapability>>;
 /** Public contract for extension capability contract, shared by SDK and presentation-layer consumers. */
 export declare const EXTENSION_CAPABILITY_CONTRACT: Readonly<{
-    version: 2;
-    capabilities: ("search" | "schema" | "commands" | "importers" | "hooks" | "renderers" | "parser" | "preflight" | "services")[];
-    legacy_aliases: {
-        [x: string]: "search" | "schema" | "commands" | "importers" | "hooks" | "renderers" | "parser" | "preflight" | "services";
-    };
+version: 2;
+capabilities: ("search" | "schema" | "commands" | "importers" | "renderers" | "hooks" | "parser" | "preflight" | "services")[];
+legacy_aliases: {
+[x: string]: "search" | "schema" | "commands" | "importers" | "renderers" | "hooks" | "parser" | "preflight" | "services";
+};
 }>;
 /** Public contract for known extension policy modes, shared by SDK and presentation-layer consumers. */
 export declare const KNOWN_EXTENSION_POLICY_MODES: readonly ["off", "warn", "enforce"];
@@ -49,10 +49,10 @@ export declare const KNOWN_PM_MAX_VERSION_EXCEEDED_MODES: readonly ["block", "wa
 export type PmMaxVersionExceededMode = (typeof KNOWN_PM_MAX_VERSION_EXCEEDED_MODES)[number];
 /** Optional per-layer override map for `extensions.policy.pm_max_version_exceeded_mode`. */
 export interface PmMaxVersionExceededModeByLayer {
-    /** Value that configures or reports global for this contract. */
-    global?: PmMaxVersionExceededMode;
-    /** Value that configures or reports project for this contract. */
-    project?: PmMaxVersionExceededMode;
+/** Value that configures or reports global for this contract. */
+global?: PmMaxVersionExceededMode;
+/** Value that configures or reports project for this contract. */
+project?: PmMaxVersionExceededMode;
 }
 /** Settings value for `extensions.policy.pm_max_version_exceeded_mode`: either a single mode applied to both layers, or a per-layer override map. Unset (and any unset layer key) defaults to `"block"`. */
 export type PmMaxVersionExceededModeSetting = PmMaxVersionExceededMode | PmMaxVersionExceededModeByLayer;
@@ -66,48 +66,48 @@ export declare const KNOWN_EXTENSION_SERVICE_NAMES: readonly ["output_format", "
 export type ExtensionServiceName = (typeof KNOWN_EXTENSION_SERVICE_NAMES)[number];
 /** Documents the extension provenance metadata payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionProvenanceMetadata {
-    /** Value that configures or reports source for this contract. */
-    source?: string;
-    /** Value that configures or reports signature for this contract. */
-    signature?: string;
-    /** Value that configures or reports attestation for this contract. */
-    attestation?: string;
-    /** Value that configures or reports verified for this contract. */
-    verified?: boolean;
+/** Value that configures or reports source for this contract. */
+source?: string;
+/** Value that configures or reports signature for this contract. */
+signature?: string;
+/** Value that configures or reports attestation for this contract. */
+attestation?: string;
+/** Value that configures or reports verified for this contract. */
+verified?: boolean;
 }
 /** Documents the extension runtime permission declaration payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionRuntimePermissionDeclaration {
-    /** Value that configures or reports fs read for this contract. */
-    fs_read?: boolean;
-    /** Value that configures or reports fs write for this contract. */
-    fs_write?: boolean;
-    /** Value that configures or reports network for this contract. */
-    network?: boolean;
-    /** Value that configures or reports env read for this contract. */
-    env_read?: boolean;
-    /** Value that configures or reports env write for this contract. */
-    env_write?: boolean;
-    /** Value that configures or reports process spawn for this contract. */
-    process_spawn?: boolean;
+/** Value that configures or reports fs read for this contract. */
+fs_read?: boolean;
+/** Value that configures or reports fs write for this contract. */
+fs_write?: boolean;
+/** Value that configures or reports network for this contract. */
+network?: boolean;
+/** Value that configures or reports env read for this contract. */
+env_read?: boolean;
+/** Value that configures or reports env write for this contract. */
+env_write?: boolean;
+/** Value that configures or reports process spawn for this contract. */
+process_spawn?: boolean;
 }
 /** Documents the extension activation metadata payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionActivationMetadata {
-    /** Value that configures or reports commands for this contract. */
-    commands?: string[];
+/** Value that configures or reports commands for this contract. */
+commands?: string[];
 }
 /** Restricts extension policy override values accepted by command, SDK, and storage contracts. */
 export type ExtensionPolicyOverride = ExtensionPolicyOverrideSettings;
 /** Extension governance policy as read from / serialized to settings. Extends the stored settings shape with `pm_max_version_exceeded_mode` (pm-k5e8), which relaxes the default-BLOCK on `pm_max_version` violations to warn-only — globally or per extension layer. */
 export type ExtensionGovernancePolicy = ExtensionPolicySettings & {
-    pm_max_version_exceeded_mode?: PmMaxVersionExceededModeSetting;
+pm_max_version_exceeded_mode?: PmMaxVersionExceededModeSetting;
 };
 /** Documents the extension manifest engines payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionManifestEngines {
-    /** Value that configures or reports pm for this contract. */
-    pm?: string;
-    /** Value that configures or reports node for this contract. */
-    node?: string;
-    [engine: string]: string | undefined;
+/** Value that configures or reports pm for this contract. */
+pm?: string;
+/** Value that configures or reports node for this contract. */
+node?: string;
+[engine: string]: string | undefined;
 }
 /** Implements create default extension governance policy for the public runtime surface of this module. */
 export declare function createDefaultExtensionGovernancePolicy(): ExtensionGovernancePolicy;
@@ -117,320 +117,320 @@ export type ExtensionLayer = "global" | "project";
 export type ExtensionStatus = "ok" | "warn";
 /** Static, serializable inventory of extension registrations available without importing its module. */
 export interface ExtensionContributionInventory {
-    /** Inventory schema version for forward-compatible persisted snapshots. */
-    schema_version: 1;
-    /** Declared command paths. */
-    commands?: string[];
-    /** Built-in command override targets. */
-    command_overrides?: string[];
-    /** Command paths backed by extension handlers. */
-    command_handlers?: string[];
-    /** Lifecycle hook phases contributed by the extension. */
-    hooks?: string[];
-    /** Command paths receiving extension flags. */
-    flag_commands?: string[];
-    /** Declared custom item types. */
-    item_types?: string[];
-    /** Declared custom item fields. */
-    item_fields?: string[];
-    /** Declared relationship kinds. */
-    relationship_kinds?: string[];
-    /** Declared schema migration identifiers. */
-    migrations?: string[];
-    /** Declared project profile names. */
-    profiles?: string[];
-    /** Declared importer names. */
-    importers?: string[];
-    /** Declared exporter names. */
-    exporters?: string[];
-    /** Declared search-provider names. */
-    search_providers?: string[];
-    /** Declared vector-store adapter names. */
-    vector_store_adapters?: string[];
-    /** Declared assurance measurement-provider ids. */
-    assurance_providers?: string[];
-    /** Parser override command targets. */
-    parser_overrides?: string[];
-    /** Service override targets. */
-    service_overrides?: string[];
-    /** Renderer formats contributed by the extension. */
-    renderer_overrides?: string[];
-    /** Optional command ownership for renderer contributions. */
-    renderer_ownership?: Array<{
-        /** Output format owned by this renderer. */
-        format: OutputRendererFormat;
-        /** Command paths on which the renderer may run. */
-        commands: string[];
-        /** Whether runtime result discrimination can select the renderer. */
-        result_discriminator: boolean;
-    }>;
-    /** Number of preflight overrides in the package. */
-    preflight_overrides?: number;
-    /** Optional command ownership for each preflight override. Empty commands mean global ownership. */
-    preflight_ownership?: Array<{
-        /** Command paths on which the override may run. */
-        commands: string[];
-    }>;
+/** Inventory schema version for forward-compatible persisted snapshots. */
+schema_version: 1;
+/** Declared command paths. */
+commands?: string[];
+/** Built-in command override targets. */
+command_overrides?: string[];
+/** Command paths backed by extension handlers. */
+command_handlers?: string[];
+/** Lifecycle hook phases contributed by the extension. */
+hooks?: string[];
+/** Command paths receiving extension flags. */
+flag_commands?: string[];
+/** Declared custom item types. */
+item_types?: string[];
+/** Declared custom item fields. */
+item_fields?: string[];
+/** Declared relationship kinds. */
+relationship_kinds?: string[];
+/** Declared schema migration identifiers. */
+migrations?: string[];
+/** Declared project profile names. */
+profiles?: string[];
+/** Declared importer names. */
+importers?: string[];
+/** Declared exporter names. */
+exporters?: string[];
+/** Declared search-provider names. */
+search_providers?: string[];
+/** Declared vector-store adapter names. */
+vector_store_adapters?: string[];
+/** Declared assurance measurement-provider ids. */
+assurance_providers?: string[];
+/** Parser override command targets. */
+parser_overrides?: string[];
+/** Service override targets. */
+service_overrides?: string[];
+/** Renderer formats contributed by the extension. */
+renderer_overrides?: string[];
+/** Optional command ownership for renderer contributions. */
+renderer_ownership?: Array<{
+/** Output format owned by this renderer. */
+format: OutputRendererFormat;
+/** Command paths on which the renderer may run. */
+commands: string[];
+/** Whether runtime result discrimination can select the renderer. */
+result_discriminator: boolean;
+}>;
+/** Number of preflight overrides in the package. */
+preflight_overrides?: number;
+/** Optional command ownership for each preflight override. Empty commands mean global ownership. */
+preflight_ownership?: Array<{
+/** Command paths on which the override may run. */
+commands: string[];
+}>;
 }
 /** Documents the extension manifest payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionManifest {
-    /** Value that configures or reports name for this contract. */
-    name: string;
-    /** Value that configures or reports version for this contract. */
-    version: string;
-    /** Value that configures or reports entry for this contract. */
-    entry: string;
-    /** Value that configures or reports priority for this contract. */
-    priority: number;
-    /** Value that configures or reports capabilities for this contract. */
-    capabilities: string[];
-    /** Value that configures or reports manifest version for this contract. */
-    manifest_version?: number;
-    /** Value that configures or reports pm min version for this contract. */
-    pm_min_version?: string;
-    /** Value that configures or reports pm max version for this contract. */
-    pm_max_version?: string;
-    /** Value that configures or reports engines for this contract. */
-    engines?: ExtensionManifestEngines;
-    /** Value that configures or reports trusted for this contract. */
-    trusted?: boolean;
-    /** Value that configures or reports provenance for this contract. */
-    provenance?: ExtensionProvenanceMetadata;
-    /** Value that configures or reports sandbox profile for this contract. */
-    sandbox_profile?: ExtensionSandboxProfile;
-    /** Value that configures or reports permissions for this contract. */
-    permissions?: ExtensionRuntimePermissionDeclaration;
-    /** Value that configures or reports activation for this contract. */
-    activation?: ExtensionActivationMetadata;
-    /** Static contribution inventory used by discovery before module import. */
-    contributions?: ExtensionContributionInventory;
-    /** Value that configures or reports legacy capability aliases for this contract. */
-    legacy_capability_aliases?: LegacyExtensionCapabilityAliasMapping[];
+/** Value that configures or reports name for this contract. */
+name: string;
+/** Value that configures or reports version for this contract. */
+version: string;
+/** Value that configures or reports entry for this contract. */
+entry: string;
+/** Value that configures or reports priority for this contract. */
+priority: number;
+/** Value that configures or reports capabilities for this contract. */
+capabilities: string[];
+/** Value that configures or reports manifest version for this contract. */
+manifest_version?: number;
+/** Value that configures or reports pm min version for this contract. */
+pm_min_version?: string;
+/** Value that configures or reports pm max version for this contract. */
+pm_max_version?: string;
+/** Value that configures or reports engines for this contract. */
+engines?: ExtensionManifestEngines;
+/** Value that configures or reports trusted for this contract. */
+trusted?: boolean;
+/** Value that configures or reports provenance for this contract. */
+provenance?: ExtensionProvenanceMetadata;
+/** Value that configures or reports sandbox profile for this contract. */
+sandbox_profile?: ExtensionSandboxProfile;
+/** Value that configures or reports permissions for this contract. */
+permissions?: ExtensionRuntimePermissionDeclaration;
+/** Value that configures or reports activation for this contract. */
+activation?: ExtensionActivationMetadata;
+/** Static contribution inventory used by discovery before module import. */
+contributions?: ExtensionContributionInventory;
+/** Value that configures or reports legacy capability aliases for this contract. */
+legacy_capability_aliases?: LegacyExtensionCapabilityAliasMapping[];
 }
 /** Documents the extension diagnostic payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionDiagnostic {
-    /** Value that configures or reports layer for this contract. */
-    layer: ExtensionLayer;
-    /** Value that configures or reports directory for this contract. */
-    directory: string;
-    /** Filesystem path used for manifest resolution. */
-    manifest_path: string;
-    /** Value that configures or reports name for this contract. */
-    name: string | null;
-    /** Value that configures or reports version for this contract. */
-    version: string | null;
-    /** Value that configures or reports entry for this contract. */
-    entry: string | null;
-    /** Value that configures or reports priority for this contract. */
-    priority: number | null;
-    /** Filesystem path used for entry resolution. */
-    entry_path: string | null;
-    /** Whether enabled applies to this operation. */
-    enabled: boolean | null;
-    /** Lifecycle state reported for status. */
-    status: ExtensionStatus;
+/** Value that configures or reports layer for this contract. */
+layer: ExtensionLayer;
+/** Value that configures or reports directory for this contract. */
+directory: string;
+/** Filesystem path used for manifest resolution. */
+manifest_path: string;
+/** Value that configures or reports name for this contract. */
+name: string | null;
+/** Value that configures or reports version for this contract. */
+version: string | null;
+/** Value that configures or reports entry for this contract. */
+entry: string | null;
+/** Value that configures or reports priority for this contract. */
+priority: number | null;
+/** Filesystem path used for entry resolution. */
+entry_path: string | null;
+/** Whether enabled applies to this operation. */
+enabled: boolean | null;
+/** Lifecycle state reported for status. */
+status: ExtensionStatus;
 }
 /** Documents the effective extension payload exchanged by command, SDK, and package integrations. */
 export interface EffectiveExtension {
-    /** Value that configures or reports layer for this contract. */
-    layer: ExtensionLayer;
-    /** Value that configures or reports directory for this contract. */
-    directory: string;
-    /** Filesystem path used for manifest resolution. */
-    manifest_path: string;
-    /** Value that configures or reports name for this contract. */
-    name: string;
-    /** Value that configures or reports source package for this contract. */
-    source_package?: string;
-    /** Install-source identities that can resolve this extension through package lifecycle commands. */
-    source_aliases?: string[];
-    /** Value that configures or reports version for this contract. */
-    version: string;
-    /** Value that configures or reports entry for this contract. */
-    entry: string;
-    /** Value that configures or reports priority for this contract. */
-    priority: number;
-    /** Filesystem path used for entry resolution. */
-    entry_path: string;
-    /** Value that configures or reports manifest version for this contract. */
-    manifest_version?: number;
-    /** Value that configures or reports pm min version for this contract. */
-    pm_min_version?: string;
-    /** Value that configures or reports pm max version for this contract. */
-    pm_max_version?: string;
-    /** Value that configures or reports engines for this contract. */
-    engines?: ExtensionManifestEngines;
-    /** Value that configures or reports trusted for this contract. */
-    trusted?: boolean;
-    /** Value that configures or reports provenance for this contract. */
-    provenance?: ExtensionProvenanceMetadata;
-    /** Value that configures or reports sandbox profile for this contract. */
-    sandbox_profile?: ExtensionSandboxProfile;
-    /** Value that configures or reports permissions for this contract. */
-    permissions?: ExtensionRuntimePermissionDeclaration;
-    /** Value that configures or reports capabilities for this contract. */
-    capabilities?: string[];
-    /** Value that configures or reports activation for this contract. */
-    activation?: ExtensionActivationMetadata;
-    /** Static contribution inventory resolved from the manifest or install snapshot. */
-    contributions?: ExtensionContributionInventory;
+/** Value that configures or reports layer for this contract. */
+layer: ExtensionLayer;
+/** Value that configures or reports directory for this contract. */
+directory: string;
+/** Filesystem path used for manifest resolution. */
+manifest_path: string;
+/** Value that configures or reports name for this contract. */
+name: string;
+/** Value that configures or reports source package for this contract. */
+source_package?: string;
+/** Install-source identities that can resolve this extension through package lifecycle commands. */
+source_aliases?: string[];
+/** Value that configures or reports version for this contract. */
+version: string;
+/** Value that configures or reports entry for this contract. */
+entry: string;
+/** Value that configures or reports priority for this contract. */
+priority: number;
+/** Filesystem path used for entry resolution. */
+entry_path: string;
+/** Value that configures or reports manifest version for this contract. */
+manifest_version?: number;
+/** Value that configures or reports pm min version for this contract. */
+pm_min_version?: string;
+/** Value that configures or reports pm max version for this contract. */
+pm_max_version?: string;
+/** Value that configures or reports engines for this contract. */
+engines?: ExtensionManifestEngines;
+/** Value that configures or reports trusted for this contract. */
+trusted?: boolean;
+/** Value that configures or reports provenance for this contract. */
+provenance?: ExtensionProvenanceMetadata;
+/** Value that configures or reports sandbox profile for this contract. */
+sandbox_profile?: ExtensionSandboxProfile;
+/** Value that configures or reports permissions for this contract. */
+permissions?: ExtensionRuntimePermissionDeclaration;
+/** Value that configures or reports capabilities for this contract. */
+capabilities?: string[];
+/** Value that configures or reports activation for this contract. */
+activation?: ExtensionActivationMetadata;
+/** Static contribution inventory resolved from the manifest or install snapshot. */
+contributions?: ExtensionContributionInventory;
 }
 /** Documents the extension discovery result payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionDiscoveryResult {
-    /** Value that configures or reports disabled by flag for this contract. */
-    disabled_by_flag: boolean;
-    /** Value that configures or reports roots for this contract. */
-    roots: {
-        global: string;
-        project: string;
-    };
-    /** Value that configures or reports configured enabled for this contract. */
-    configured_enabled: string[];
-    /** Value that configures or reports configured disabled for this contract. */
-    configured_disabled: string[];
-    /** Value that configures or reports discovered for this contract. */
-    discovered: ExtensionDiagnostic[];
-    /** Value that configures or reports effective for this contract. */
-    effective: EffectiveExtension[];
-    /** Value that configures or reports warnings for this contract. */
-    warnings: string[];
-    /** Value that configures or reports policy for this contract. */
-    policy: ExtensionGovernancePolicy;
+/** Value that configures or reports disabled by flag for this contract. */
+disabled_by_flag: boolean;
+/** Value that configures or reports roots for this contract. */
+roots: {
+global: string;
+project: string;
+};
+/** Value that configures or reports configured enabled for this contract. */
+configured_enabled: string[];
+/** Value that configures or reports configured disabled for this contract. */
+configured_disabled: string[];
+/** Value that configures or reports discovered for this contract. */
+discovered: ExtensionDiagnostic[];
+/** Value that configures or reports effective for this contract. */
+effective: EffectiveExtension[];
+/** Value that configures or reports warnings for this contract. */
+warnings: string[];
+/** Value that configures or reports policy for this contract. */
+policy: ExtensionGovernancePolicy;
 }
 /** Documents the loaded extension payload exchanged by command, SDK, and package integrations. */
 export interface LoadedExtension extends EffectiveExtension {
-    /** Value that configures or reports module for this contract. */
-    module: unknown;
+/** Value that configures or reports module for this contract. */
+module: unknown;
 }
 /** Documents the failed extension load payload exchanged by command, SDK, and package integrations. */
 export interface FailedExtensionLoad {
-    /** Value that configures or reports layer for this contract. */
-    layer: ExtensionLayer;
-    /** Value that configures or reports name for this contract. */
-    name: string;
-    /** Filesystem path used for entry resolution. */
-    entry_path: string;
-    /** Value that configures or reports error for this contract. */
-    error: string;
+/** Value that configures or reports layer for this contract. */
+layer: ExtensionLayer;
+/** Value that configures or reports name for this contract. */
+name: string;
+/** Filesystem path used for entry resolution. */
+entry_path: string;
+/** Value that configures or reports error for this contract. */
+error: string;
 }
 /** Documents the extension load result payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionLoadResult extends ExtensionDiscoveryResult {
-    /** Value that configures or reports loaded for this contract. */
-    loaded: LoadedExtension[];
-    /** Value that configures or reports failed for this contract. */
-    failed: FailedExtensionLoad[];
+/** Value that configures or reports loaded for this contract. */
+loaded: LoadedExtension[];
+/** Value that configures or reports failed for this contract. */
+failed: FailedExtensionLoad[];
 }
 /** Documents the before command hook context payload exchanged by command, SDK, and package integrations. */
 export interface BeforeCommandHookContext {
-    /** Value that configures or reports command for this contract. */
-    command: string;
-    /** Value that configures or reports args for this contract. */
-    args: string[];
-    /** Value that configures or reports options for this contract. */
-    options?: Record<string, unknown>;
-    /** Value that configures or reports global for this contract. */
-    global?: GlobalOptions;
-    /** Value that configures or reports pm root for this contract. */
-    pm_root: string;
+/** Value that configures or reports command for this contract. */
+command: string;
+/** Value that configures or reports args for this contract. */
+args: string[];
+/** Value that configures or reports options for this contract. */
+options?: Record<string, unknown>;
+/** Value that configures or reports global for this contract. */
+global?: GlobalOptions;
+/** Value that configures or reports pm root for this contract. */
+pm_root: string;
 }
 /** Documents the after command hook context payload exchanged by command, SDK, and package integrations. */
 export interface AfterCommandHookContext extends BeforeCommandHookContext {
-    /** Whether the operation completed without a blocking failure. */
-    ok: boolean;
-    /** Value that configures or reports error for this contract. */
-    error?: string;
-    /** Value that configures or reports result for this contract. */
-    result?: unknown;
-    /** Value that configures or reports affected for this contract. */
-    affected?: AfterCommandAffectedItem[];
+/** Whether the operation completed without a blocking failure. */
+ok: boolean;
+/** Value that configures or reports error for this contract. */
+error?: string;
+/** Value that configures or reports result for this contract. */
+result?: unknown;
+/** Value that configures or reports affected for this contract. */
+affected?: AfterCommandAffectedItem[];
 }
 /** Documents the after command affected item payload exchanged by command, SDK, and package integrations. */
 export interface AfterCommandAffectedItem {
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
-    /** Value that configures or reports op for this contract. */
-    op?: string;
-    /** Schema type that determines the shape and validation rules for this value. */
-    item_type?: string;
-    /** Status id the item held before this mutation. */
-    previous_status?: ItemStatus;
-    /** Lifecycle state reported for status. */
-    status?: ItemStatus;
-    /** Value that configures or reports previous for this contract. */
-    previous?: Partial<ItemMetadata>;
-    /** Value that configures or reports current for this contract. */
-    current?: Partial<ItemMetadata>;
-    /** Value that configures or reports changed fields for this contract. */
-    changed_fields?: string[];
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Value that configures or reports op for this contract. */
+op?: string;
+/** Schema type that determines the shape and validation rules for this value. */
+item_type?: string;
+/** Status id the item held before this mutation. */
+previous_status?: ItemStatus;
+/** Lifecycle state reported for status. */
+status?: ItemStatus;
+/** Value that configures or reports previous for this contract. */
+previous?: Partial<ItemMetadata>;
+/** Value that configures or reports current for this contract. */
+current?: Partial<ItemMetadata>;
+/** Value that configures or reports changed fields for this contract. */
+changed_fields?: string[];
 }
 /** Documents the on write hook context payload exchanged by command, SDK, and package integrations. */
 export interface OnWriteHookContext {
-    /** Filesystem path used for path resolution. */
-    path: string;
-    /** Value that configures or reports scope for this contract. */
-    scope: "project" | "global";
-    /** Value that configures or reports op for this contract. */
-    op: string;
-    /** Value that configures or reports item id for this contract. */
-    item_id?: string;
-    /** Schema type that determines the shape and validation rules for this value. */
-    item_type?: string;
-    /** Value that configures or reports before for this contract. */
-    before?: ItemDocument;
-    /** Value that configures or reports after for this contract. */
-    after?: ItemDocument;
-    /** Value that configures or reports changed fields for this contract. */
-    changed_fields?: string[];
+/** Filesystem path used for path resolution. */
+path: string;
+/** Value that configures or reports scope for this contract. */
+scope: "project" | "global";
+/** Value that configures or reports op for this contract. */
+op: string;
+/** Value that configures or reports item id for this contract. */
+item_id?: string;
+/** Schema type that determines the shape and validation rules for this value. */
+item_type?: string;
+/** Value that configures or reports before for this contract. */
+before?: ItemDocument;
+/** Value that configures or reports after for this contract. */
+after?: ItemDocument;
+/** Value that configures or reports changed fields for this contract. */
+changed_fields?: string[];
 }
 /** Read-only tracker services available while an extension evaluates a proposed mutation. */
 export interface ExtensionMutationGuardSdk {
-    /** Read one item from the guard's host-bound tracker, or return null when it is absent. */
-    get(id: string): Promise<{
-        item: ItemMetadata;
-        body: string;
-    } | null>;
-    /** List item metadata from the guard's host-bound tracker. */
-    list(): Promise<ItemMetadata[]>;
+/** Read one item from the guard's host-bound tracker, or return null when it is absent. */
+get(id: string): Promise<{
+item: ItemMetadata;
+body: string;
+} | null>;
+/** List item metadata from the guard's host-bound tracker. */
+list(): Promise<ItemMetadata[]>;
 }
 /** Proposed item transition supplied before either the item or history artifact is persisted. */
 export interface BeforeMutationHookContext {
-    /** Tracker root owning the transaction. */
-    pm_root: string;
-    /** Stable mutation operation name such as create, update, close, delete, or restore. */
-    operation: string;
-    /** Canonical item state before the mutation, or null for create. */
-    before: ItemDocument | null;
-    /** Canonical proposed state after the mutation, or null for delete. */
-    after: ItemDocument | null;
-    /** Canonical fields the transaction proposes to change. */
-    changed_fields: readonly string[];
-    /** Host-bound read-only SDK services. */
-    sdk: ExtensionMutationGuardSdk;
+/** Tracker root owning the transaction. */
+pm_root: string;
+/** Stable mutation operation name such as create, update, close, delete, or restore. */
+operation: string;
+/** Canonical item state before the mutation, or null for create. */
+before: ItemDocument | null;
+/** Canonical proposed state after the mutation, or null for delete. */
+after: ItemDocument | null;
+/** Canonical fields the transaction proposes to change. */
+changed_fields: readonly string[];
+/** Host-bound read-only SDK services. */
+sdk: ExtensionMutationGuardSdk;
 }
 /** Stable decision returned by a transactional extension mutation guard. */
 export type BeforeMutationHookDecision = {
-    allow: true;
+allow: true;
 } | {
-    allow: false;
-    code: string;
-    message?: string;
-    remediation: string;
+allow: false;
+code: string;
+message?: string;
+remediation: string;
 };
 /** A fail-closed hook evaluated inside the item lock before persistence. */
 export type BeforeMutationHook = (context: BeforeMutationHookContext) => Promise<BeforeMutationHookDecision | void> | BeforeMutationHookDecision | void;
 /** Documents the on read hook context payload exchanged by command, SDK, and package integrations. */
 export interface OnReadHookContext {
-    /** Filesystem path used for path resolution. */
-    path: string;
-    /** Value that configures or reports scope for this contract. */
-    scope: "project" | "global";
+/** Filesystem path used for path resolution. */
+path: string;
+/** Value that configures or reports scope for this contract. */
+scope: "project" | "global";
 }
 /** Documents the on index hook context payload exchanged by command, SDK, and package integrations. */
 export interface OnIndexHookContext {
-    /** Value that configures or reports mode for this contract. */
-    mode: string;
-    /** Value that configures or reports total items for this contract. */
-    total_items?: number;
+/** Value that configures or reports mode for this contract. */
+mode: string;
+/** Value that configures or reports total items for this contract. */
+total_items?: number;
 }
 /** Restricts before command hook values accepted by command, SDK, and storage contracts. */
 export type BeforeCommandHook = (context: BeforeCommandHookContext) => Promise<void> | void;
@@ -450,15 +450,15 @@ export type CommandOverride = (context: CommandOverrideContext) => unknown;
 export type RendererOverride = (context: RendererOverrideContext) => string | null | undefined;
 /** Host-enforced ownership metadata that limits where a renderer override may run. */
 export interface RendererOverrideOwnership {
-    /** Normalized command paths this renderer owns. An unrelated command never reaches the callback. */
-    commands?: string[];
-    /** Optional result predicate evaluated before the renderer callback. A false result preserves native rendering. */
-    resultDiscriminator?: (result: unknown) => boolean;
+/** Normalized command paths this renderer owns. An unrelated command never reaches the callback. */
+commands?: string[];
+/** Optional result predicate evaluated before the renderer callback. A false result preserves native rendering. */
+resultDiscriminator?: (result: unknown) => boolean;
 }
 /** Declarative renderer definition combining a callback with host-enforced ownership. */
 export interface ScopedRendererOverrideDefinition extends RendererOverrideOwnership {
-    /** Renderer callback invoked only after every declared ownership predicate matches. */
-    run: RendererOverride;
+/** Renderer callback invoked only after every declared ownership predicate matches. */
+run: RendererOverride;
 }
 /** Restricts command handler values accepted by command, SDK, and storage contracts. */
 export type CommandHandler = (context: CommandHandlerContext) => unknown;
@@ -468,255 +468,262 @@ export type ParserOverride = (context: ParserOverrideContext) => ParserOverrideD
 export type PreflightOverride = (context: PreflightOverrideContext) => PreflightOverrideDelta | Promise<PreflightOverrideDelta>;
 /** Static ownership declaration used to select and diagnose preflight overrides. */
 export interface PreflightOverrideOwnership {
-    /** Normalized command paths on which this preflight override may run. */
-    commands?: string[];
+/** Normalized command paths on which this preflight override may run. */
+commands?: string[];
 }
 /** Declarative preflight override paired with statically inspectable ownership. */
 export interface ScopedPreflightOverrideDefinition extends PreflightOverrideOwnership {
-    /** Preflight handler invoked only for a declared command, or globally when unscoped. */
-    run: PreflightOverride;
+/** Preflight handler invoked only for a declared command, or globally when unscoped. */
+run: PreflightOverride;
 }
 /** Explicitly claims or declines one service payload without relying on object identity. */
 export type ServiceOverrideDecision = {
-    handled: true;
-    result: unknown;
+handled: true;
+result: unknown;
 } | {
-    handled: false;
+handled: false;
 };
 /** Restricts service override values accepted by command, SDK, and storage contracts. */
 export type ServiceOverride = (context: ServiceOverrideContext) => unknown | ServiceOverrideDecision;
 /** Host-enforced ownership metadata for a service override. */
 export interface ServiceOverrideOwnership {
-    /** Declare that the callback may only decline. Any handled result is ignored and diagnosed by the host. */
-    passThrough?: boolean;
+/** Declare that the callback may only decline. Any handled result is ignored and diagnosed by the host. */
+passThrough?: boolean;
 }
 /** Documents the registered extension hook payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredExtensionHook<THook> {
-    /** Value that configures or reports layer for this contract. */
-    layer: ExtensionLayer;
-    /** Value that configures or reports name for this contract. */
-    name: string;
-    /** Value that configures or reports run for this contract. */
-    run: THook;
+/** Value that configures or reports layer for this contract. */
+layer: ExtensionLayer;
+/** Value that configures or reports name for this contract. */
+name: string;
+/** Value that configures or reports run for this contract. */
+run: THook;
 }
 /** Documents the extension hook registry payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionHookRegistry {
-    /** Value that configures or reports before command for this contract. */
-    beforeCommand: Array<RegisteredExtensionHook<BeforeCommandHook>>;
-    /** Transactional guards fired before item and history persistence. */
-    beforeMutation: Array<RegisteredExtensionHook<BeforeMutationHook>>;
-    /** Value that configures or reports after command for this contract. */
-    afterCommand: Array<RegisteredExtensionHook<AfterCommandHook>>;
-    /** Value that configures or reports on write for this contract. */
-    onWrite: Array<RegisteredExtensionHook<OnWriteHook>>;
-    /** Value that configures or reports on read for this contract. */
-    onRead: Array<RegisteredExtensionHook<OnReadHook>>;
-    /** Value that configures or reports on index for this contract. */
-    onIndex: Array<RegisteredExtensionHook<OnIndexHook>>;
+/** Value that configures or reports before command for this contract. */
+beforeCommand: Array<RegisteredExtensionHook<BeforeCommandHook>>;
+/** Transactional guards fired before item and history persistence. */
+beforeMutation: Array<RegisteredExtensionHook<BeforeMutationHook>>;
+/** Value that configures or reports after command for this contract. */
+afterCommand: Array<RegisteredExtensionHook<AfterCommandHook>>;
+/** Value that configures or reports on write for this contract. */
+onWrite: Array<RegisteredExtensionHook<OnWriteHook>>;
+/** Value that configures or reports on read for this contract. */
+onRead: Array<RegisteredExtensionHook<OnReadHook>>;
+/** Value that configures or reports on index for this contract. */
+onIndex: Array<RegisteredExtensionHook<OnIndexHook>>;
 }
 /** Portable workspace coordinates supplied to every extension runtime surface. */
 export interface PortableWorkspaceContext {
-    /** Immutable source workspace root, distinct from a sandboxed tracker root. */
-    source_workspace_root?: string;
-    /** Source VCS repository root when one can be resolved. */
-    repo_root?: string;
-    /** POSIX tracker path relative to the source workspace when contained there. */
-    pm_root_rel?: string;
+/** Immutable source workspace root, distinct from a sandboxed tracker root. */
+source_workspace_root?: string;
+/** Source VCS repository root when one can be resolved. */
+repo_root?: string;
+/** POSIX tracker path relative to the source workspace when contained there. */
+pm_root_rel?: string;
 }
 /** Documents the command override context payload exchanged by command, SDK, and package integrations. */
 export interface CommandOverrideContext extends PortableWorkspaceContext {
-    /** Value that configures or reports command for this contract. */
-    command: string;
-    /** Value that configures or reports args for this contract. */
-    args: string[];
-    /** Value that configures or reports options for this contract. */
-    options?: Record<string, unknown>;
-    /** Value that configures or reports global for this contract. */
-    global?: GlobalOptions;
-    /** Value that configures or reports pm root for this contract. */
-    pm_root: string;
-    /** Value that configures or reports result for this contract. */
-    result: unknown;
+/** Value that configures or reports command for this contract. */
+command: string;
+/** Value that configures or reports args for this contract. */
+args: string[];
+/** Value that configures or reports options for this contract. */
+options?: Record<string, unknown>;
+/** Value that configures or reports global for this contract. */
+global?: GlobalOptions;
+/** Value that configures or reports pm root for this contract. */
+pm_root: string;
+/** Value that configures or reports result for this contract. */
+result: unknown;
 }
 /** Documents the renderer override context payload exchanged by command, SDK, and package integrations. */
 export interface RendererOverrideContext extends Partial<PortableWorkspaceContext> {
-    /** Value that configures or reports format for this contract. */
-    format: OutputRendererFormat;
-    /** Value that configures or reports command for this contract. */
-    command?: string;
-    /** Value that configures or reports args for this contract. */
-    args?: string[];
-    /** Value that configures or reports options for this contract. */
-    options?: Record<string, unknown>;
-    /** Value that configures or reports global for this contract. */
-    global?: GlobalOptions;
-    /** Value that configures or reports pm root for this contract. */
-    pm_root?: string;
-    /** Value that configures or reports result for this contract. */
-    result: unknown;
+/** Value that configures or reports format for this contract. */
+format: OutputRendererFormat;
+/** Value that configures or reports command for this contract. */
+command?: string;
+/** Value that configures or reports args for this contract. */
+args?: string[];
+/** Value that configures or reports options for this contract. */
+options?: Record<string, unknown>;
+/** Value that configures or reports global for this contract. */
+global?: GlobalOptions;
+/** Value that configures or reports pm root for this contract. */
+pm_root?: string;
+/** Value that configures or reports result for this contract. */
+result: unknown;
 }
 /** Documents the command handler context payload exchanged by command, SDK, and package integrations. */
 export interface CommandHandlerContext extends PortableWorkspaceContext {
-    /** Value that configures or reports command for this contract. */
-    command: string;
-    /** Value that configures or reports args for this contract. */
-    args: string[];
-    /** Value that configures or reports options for this contract. */
-    options: Record<string, unknown>;
-    /** Value that configures or reports global for this contract. */
-    global: GlobalOptions;
-    /** Value that configures or reports pm root for this contract. */
-    pm_root: string;
-    /** Host-bound SDK runtime that avoids package-resolution and private-import coupling. */
-    sdk?: ExtensionCommandSdk;
+/** Value that configures or reports command for this contract. */
+command: string;
+/** Value that configures or reports args for this contract. */
+args: string[];
+/** Value that configures or reports options for this contract. */
+options: Record<string, unknown>;
+/** Value that configures or reports global for this contract. */
+global: GlobalOptions;
+/** Value that configures or reports pm root for this contract. */
+pm_root: string;
+/** Host-bound SDK runtime that avoids package-resolution and private-import coupling. */
+sdk?: ExtensionCommandSdk;
 }
 /** Runtime SDK services injected into every extension command invocation. */
 export interface ExtensionCommandSdk {
-    /** Tracker-bound client using the invocation author and workspace. */
-    client: PmClient;
-    /** Classify a host-native or structurally compatible missing-item error. */
-    isItemNotFoundError(error: unknown): boolean;
-    /** Reconstruct one item at a history version or timestamp. */
-    getItemAt(id: string, target: string): Promise<GetItemAtResult>;
-    /** Open a durable event store with package-contributed relationship semantics. */
-    openRelationshipEventStore(options: {
-        nodes: Iterable<string>;
-        definitions: readonly RelationshipKindDefinition[];
-        relativePath?: string;
-    }): Promise<RelationshipEventStore>;
-    /** Materialize a validated in-memory graph without resolving the SDK package at runtime. */
-    createRelationshipGraph(options: {
-        nodes: Iterable<string>;
-        edges: Iterable<RelationshipEdge>;
-        definitions: readonly RelationshipKindDefinition[];
-    }): RelationshipGraph;
-    /** Compute bounded exact impact through the host-owned relationship runtime. */
-    analyzeRelationshipImpact(graph: RelationshipGraph, root: string, options?: RelationshipQueryOptions): RelationshipImpactAnalysis;
-    /** Validate an immutable relationship event batch without persisting it. */
-    validateRelationshipEvents(options: {
-        nodes: Iterable<string>;
-        definitions: readonly RelationshipKindDefinition[];
-        events: readonly RelationshipEventInput[];
-    }): RelationshipEvent[];
-    /** Commit idempotent item and relationship mutations under one durable journal. */
-    commitWorkspaceTransaction(options: Omit<CommitWorkspaceTransactionOptions, "pmRoot">): Promise<WorkspaceTransactionCommitResult>;
-    /** Mutate governed project settings under the host's workspace audit lock. */
-    mutateWorkspaceSettings(options: {
-        /** Stable identity for replay-safe retries of this invocation. */
-        operationId: string;
-        /** Compute a preview without changing settings or workspace history. */
-        dryRun?: boolean;
-        /** Include the canonical inline settings tree; omit by default to bound receipts. */
-        includePreview?: boolean;
-        /** Replace these dot-delimited inline object subtrees, removing omitted raw keys while preserving all other source fields. */
-        replaceSubtrees?: readonly string[];
-        /** Derive the complete next settings tree from normalized inline settings at lock time. */
-        mutate: (current: PmSettings) => PmSettings | Promise<PmSettings>;
-    }): Promise<{
-        /** Whether the locked settings bytes would change, or did change on apply. */
-        changed: boolean;
-        /** Whether persistence was suppressed for this invocation. */
-        dry_run: boolean;
-        /** Whether the operation was already committed and the callback was skipped. */
-        replayed: boolean;
-        /** Settings resolved from the exact persisted bytes, before optional file-backed schema overlays. Absent on replay. */
-        preview?: PmSettings;
-    }>;
+/** Tracker-bound client using the invocation author and workspace. */
+client: PmClient;
+/** Classify a host-native or structurally compatible missing-item error. */
+isItemNotFoundError(error: unknown): boolean;
+/** Reconstruct one item at a history version or timestamp. */
+getItemAt(id: string, target: string): Promise<GetItemAtResult>;
+/** Open a durable event store with package-contributed relationship semantics. */
+openRelationshipEventStore(options: {
+nodes: Iterable<string>;
+definitions: readonly RelationshipKindDefinition[];
+relativePath?: string;
+}): Promise<RelationshipEventStore>;
+/** Materialize a validated in-memory graph without resolving the SDK package at runtime. */
+createRelationshipGraph(options: {
+nodes: Iterable<string>;
+edges: Iterable<RelationshipEdge>;
+definitions: readonly RelationshipKindDefinition[];
+}): RelationshipGraph;
+/** Compute bounded exact impact through the host-owned relationship runtime. */
+analyzeRelationshipImpact(graph: RelationshipGraph, root: string, options?: RelationshipQueryOptions): RelationshipImpactAnalysis;
+/** Validate an immutable relationship event batch without persisting it. */
+validateRelationshipEvents(options: {
+nodes: Iterable<string>;
+definitions: readonly RelationshipKindDefinition[];
+events: readonly RelationshipEventInput[];
+}): RelationshipEvent[];
+/** Commit idempotent item and relationship mutations under one durable journal. */
+commitWorkspaceTransaction(options: Omit<CommitWorkspaceTransactionOptions, "pmRoot">): Promise<WorkspaceTransactionCommitResult>;
+/** Mutate governed project settings under the host's workspace audit lock. */
+mutateWorkspaceSettings(options: {
+/** Stable identity for replay-safe retries of this invocation. */
+operationId: string;
+/** Compute a preview without changing settings or workspace history. */
+dryRun?: boolean;
+/** Include the canonical inline settings tree; omit by default to bound receipts. */
+includePreview?: boolean;
+/** Replace these dot-delimited inline object subtrees, removing omitted raw keys while preserving all other source fields. */
+replaceSubtrees?: readonly string[];
+/** Derive the complete next settings tree from normalized inline settings at lock time. */
+mutate: (current: PmSettings) => PmSettings | Promise<PmSettings>;
+}): Promise<{
+/** Whether the locked settings bytes would change, or did change on apply. */
+changed: boolean;
+/** Whether persistence was suppressed for this invocation. */
+dry_run: boolean;
+/** Whether the operation was already committed and the callback was skipped. */
+replayed: boolean;
+/** Settings resolved from the exact persisted bytes, before optional file-backed schema overlays. Absent on replay. */
+preview?: PmSettings;
+}>;
 }
 /** Documents the parser override context payload exchanged by command, SDK, and package integrations. */
 export type ParserOverrideContext = CommandHandlerContext;
 /** Documents the parser override delta payload exchanged by command, SDK, and package integrations. */
 export interface ParserOverrideDelta {
-    /** Value that configures or reports args for this contract. */
-    args?: string[];
-    /** Value that configures or reports options for this contract. */
-    options?: Record<string, unknown>;
-    /** Value that configures or reports global for this contract. */
-    global?: GlobalOptions;
+/** Value that configures or reports args for this contract. */
+args?: string[];
+/** Value that configures or reports options for this contract. */
+options?: Record<string, unknown>;
+/** Value that configures or reports global for this contract. */
+global?: GlobalOptions;
 }
 /** Documents the preflight override context payload exchanged by command, SDK, and package integrations. */
 export interface PreflightOverrideContext extends CommandHandlerContext {
-    /** Value that configures or reports decision for this contract. */
-    decision: PreflightRuntimeDecision;
+/** Value that configures or reports decision for this contract. */
+decision: PreflightRuntimeDecision;
 }
 /** Documents the preflight runtime decision payload exchanged by command, SDK, and package integrations. */
 export interface PreflightRuntimeDecision {
-    /** Value that configures or reports enforce item format gate for this contract. */
-    enforce_item_format_gate: boolean;
-    /** Executes the preflight item format sync operation through the package runtime. */
-    run_preflight_item_format_sync: boolean;
-    /** Executes the extension migrations operation through the package runtime. */
-    run_extension_migrations: boolean;
-    /** Value that configures or reports enforce mandatory migration gate for this contract. */
-    enforce_mandatory_migration_gate: boolean;
+/** Value that configures or reports enforce item format gate for this contract. */
+enforce_item_format_gate: boolean;
+/** Executes the preflight item format sync operation through the package runtime. */
+run_preflight_item_format_sync: boolean;
+/** Executes the extension migrations operation through the package runtime. */
+run_extension_migrations: boolean;
+/** Value that configures or reports enforce mandatory migration gate for this contract. */
+enforce_mandatory_migration_gate: boolean;
 }
 /** Documents the preflight override delta payload exchanged by command, SDK, and package integrations. */
 export interface PreflightOverrideDelta extends ParserOverrideDelta {
-    /** Value that configures or reports enforce item format gate for this contract. */
-    enforce_item_format_gate?: boolean;
-    /** Executes the preflight item format sync operation through the package runtime. */
-    run_preflight_item_format_sync?: boolean;
-    /** Executes the extension migrations operation through the package runtime. */
-    run_extension_migrations?: boolean;
-    /** Value that configures or reports enforce mandatory migration gate for this contract. */
-    enforce_mandatory_migration_gate?: boolean;
+/** Value that configures or reports enforce item format gate for this contract. */
+enforce_item_format_gate?: boolean;
+/** Executes the preflight item format sync operation through the package runtime. */
+run_preflight_item_format_sync?: boolean;
+/** Executes the extension migrations operation through the package runtime. */
+run_extension_migrations?: boolean;
+/** Value that configures or reports enforce mandatory migration gate for this contract. */
+enforce_mandatory_migration_gate?: boolean;
 }
 /** Documents the service override context payload exchanged by command, SDK, and package integrations. */
 export interface ServiceOverrideContext extends Partial<PortableWorkspaceContext> {
-    /** Value that configures or reports service for this contract. */
-    service: ExtensionServiceName;
-    /** Value that configures or reports command for this contract. */
-    command?: string;
-    /** Value that configures or reports args for this contract. */
-    args?: string[];
-    /** Value that configures or reports options for this contract. */
-    options?: Record<string, unknown>;
-    /** Value that configures or reports global for this contract. */
-    global?: GlobalOptions;
-    /** Value that configures or reports pm root for this contract. */
-    pm_root?: string;
-    /** Value that configures or reports payload for this contract. */
-    payload: unknown;
+/** Value that configures or reports service for this contract. */
+service: ExtensionServiceName;
+/** Value that configures or reports command for this contract. */
+command?: string;
+/** Value that configures or reports args for this contract. */
+args?: string[];
+/** Value that configures or reports options for this contract. */
+options?: Record<string, unknown>;
+/** Value that configures or reports global for this contract. */
+global?: GlobalOptions;
+/** Value that configures or reports pm root for this contract. */
+pm_root?: string;
+/** Value that configures or reports payload for this contract. */
+payload: unknown;
 }
 /** Documents the extension command argument definition payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionCommandArgumentDefinition {
-    /** Value that configures or reports name for this contract. */
-    name: string;
-    /** Value that configures or reports required for this contract. */
-    required?: boolean;
-    /** Value that configures or reports variadic for this contract. */
-    variadic?: boolean;
-    /** Value that configures or reports description for this contract. */
-    description?: string;
+/** Value that configures or reports name for this contract. */
+name: string;
+/** Value that configures or reports required for this contract. */
+required?: boolean;
+/** Value that configures or reports variadic for this contract. */
+variadic?: boolean;
+/** Value that configures or reports description for this contract. */
+description?: string;
 }
 /** Documents the command definition payload exchanged by command, SDK, and package integrations. */
 export interface CommandDefinition {
-    /** Value that configures or reports name for this contract. */
-    name: string;
-    /** Value that configures or reports run for this contract. */
-    run?: CommandHandler;
-    /**
+/** Opt a read-only handler into host projection, row bounds, budgets and continuation. */
+read_output?: ExtensionCommandReadOutput;
+/** Value that configures or reports name for this contract. */
+name: string;
+/** Value that configures or reports run for this contract. */
+run?: CommandHandler;
+/**
      * @deprecated Use `run` instead. This alias remains for backward compatibility.
      */
-    handler?: CommandHandler;
-    /** Value that configures or reports action for this contract. */
-    action?: string;
-    /** Value that configures or reports description for this contract. */
-    description?: string;
-    /** Value that configures or reports intent for this contract. */
-    intent?: string;
-    /** Value that configures or reports examples for this contract. */
-    examples?: string[];
-    /** Value that configures or reports failure hints for this contract. */
-    failure_hints?: string[];
-    /** Value that configures or reports arguments for this contract. */
-    arguments?: ExtensionCommandArgumentDefinition[];
-    /** Value that configures or reports flags for this contract. */
-    flags?: FlagDefinition[];
-    /** Minimum agent surface tier that should advertise this command. */
-    tier?: "core" | "standard" | "full" | "internal";
-    /** Capability family used by generated agent routing surfaces. */
-    family?: ExtensionCommandCapabilityFamily;
+handler?: CommandHandler;
+/** Value that configures or reports action for this contract. */
+action?: string;
+/** Value that configures or reports description for this contract. */
+description?: string;
+/** Value that configures or reports intent for this contract. */
+intent?: string;
+/** Value that configures or reports examples for this contract. */
+examples?: string[];
+/** Value that configures or reports failure hints for this contract. */
+failure_hints?: string[];
+/** Value that configures or reports arguments for this contract. */
+arguments?: ExtensionCommandArgumentDefinition[];
+/** Value that configures or reports flags for this contract. */
+flags?: FlagDefinition[];
+/** Minimum agent surface tier that should advertise this command. */
+tier?: "core" | "standard" | "full" | "internal";
+/** Capability family used by generated agent routing surfaces. */
+family?: ExtensionCommandCapabilityFamily;
+}
+/** Structured rows a read-only extension command returns for host output shaping. */
+export interface ExtensionCommandReadOutput {
+/** Dot-delimited array or object-map paths; an empty list declares a singleton result. */
+row_keys: readonly string[];
 }
 /**
  * Optional command-definition metadata for first-class importer/exporter
@@ -731,197 +738,197 @@ export interface CommandDefinition {
  * they are not part of this options object.
  */
 export interface ImportExportRegistrationOptions {
-    /** Value that configures or reports action for this contract. */
-    action?: string;
-    /** Value that configures or reports description for this contract. */
-    description?: string;
-    /** Value that configures or reports intent for this contract. */
-    intent?: string;
-    /** Value that configures or reports examples for this contract. */
-    examples?: string[];
-    /** Value that configures or reports failure hints for this contract. */
-    failure_hints?: string[];
-    /** Value that configures or reports arguments for this contract. */
-    arguments?: ExtensionCommandArgumentDefinition[];
-    /** Value that configures or reports flags for this contract. */
-    flags?: FlagDefinition[];
+/** Value that configures or reports action for this contract. */
+action?: string;
+/** Value that configures or reports description for this contract. */
+description?: string;
+/** Value that configures or reports intent for this contract. */
+intent?: string;
+/** Value that configures or reports examples for this contract. */
+examples?: string[];
+/** Value that configures or reports failure hints for this contract. */
+failure_hints?: string[];
+/** Value that configures or reports arguments for this contract. */
+arguments?: ExtensionCommandArgumentDefinition[];
+/** Value that configures or reports flags for this contract. */
+flags?: FlagDefinition[];
 }
 /**
  * Declares where an exporter writes its artifact and whether the host may
  * render the returned structured receipt after the exporter completes.
  */
 export type ExporterArtifactOutputContract = {
-    /** Stdout exclusively carries artifact bytes. */
-    channel: "stdout";
-    /** Stdout artifacts cannot opt back into host rendering. */
-    receipt?: "suppress";
-    /** Optional IANA media type describing the emitted artifact. */
-    media_type?: string;
+/** Stdout exclusively carries artifact bytes. */
+channel: "stdout";
+/** Stdout artifacts cannot opt back into host rendering. */
+receipt?: "suppress";
+/** Optional IANA media type describing the emitted artifact. */
+media_type?: string;
 } | {
-    /** The exporter writes its artifact to a file. */
-    channel: "file";
-    /** File exporters may render or suppress their bounded receipt. */
-    receipt?: "suppress" | "render";
-    /** Optional IANA media type describing the emitted artifact. */
-    media_type?: string;
+/** The exporter writes its artifact to a file. */
+channel: "file";
+/** File exporters may render or suppress their bounded receipt. */
+receipt?: "suppress" | "render";
+/** Optional IANA media type describing the emitted artifact. */
+media_type?: string;
 };
 /** Exporter command metadata plus its optional artifact-delivery contract. */
 export interface ExporterRegistrationOptions extends ImportExportRegistrationOptions {
-    /** Declaration for artifact bytes and the host receipt. */
-    output?: ExporterArtifactOutputContract;
+/** Declaration for artifact bytes and the host receipt. */
+output?: ExporterArtifactOutputContract;
 }
 /** Fully normalized exporter artifact contract stored in inventories. */
 export interface RegisteredExporterArtifactOutputContract {
-    /** Destination carrying the artifact bytes. */
-    channel: "stdout" | "file";
-    /** Explicit host receipt policy after normalization. */
-    receipt: "suppress" | "render";
-    /** Optional IANA media type describing the emitted artifact. */
-    media_type?: string;
+/** Destination carrying the artifact bytes. */
+channel: "stdout" | "file";
+/** Explicit host receipt policy after normalization. */
+receipt: "suppress" | "render";
+/** Optional IANA media type describing the emitted artifact. */
+media_type?: string;
 }
 /** Restricts flag value type values accepted by command, SDK, and storage contracts. */
 export type FlagValueType = "string" | "number" | "boolean";
 /** Documents the flag definition payload exchanged by command, SDK, and package integrations. */
 export interface FlagDefinition {
-    /** Value that configures or reports long for this contract. */
-    long?: string;
-    /** Value that configures or reports short for this contract. */
-    short?: string;
-    /** Value that configures or reports value name for this contract. */
-    value_name?: string;
-    /** Value that configures or reports description for this contract. */
-    description?: string;
-    /** Value that configures or reports required for this contract. */
-    required?: boolean;
-    /** Whether enabled applies to this operation. */
-    enabled?: boolean;
-    /** Value that configures or reports visible for this contract. */
-    visible?: boolean;
-    /** Canonical flag value type. Prefer this field; it is the one runtime contracts and help output read first. */
-    value_type?: FlagValueType;
-    /**
+/** Value that configures or reports long for this contract. */
+long?: string;
+/** Value that configures or reports short for this contract. */
+short?: string;
+/** Value that configures or reports value name for this contract. */
+value_name?: string;
+/** Value that configures or reports description for this contract. */
+description?: string;
+/** Value that configures or reports required for this contract. */
+required?: boolean;
+/** Whether enabled applies to this operation. */
+enabled?: boolean;
+/** Value that configures or reports visible for this contract. */
+visible?: boolean;
+/** Canonical flag value type. Prefer this field; it is the one runtime contracts and help output read first. */
+value_type?: FlagValueType;
+/**
      * @deprecated Use `value_type`. Retained for backward compatibility: when
      * both are present `value_type` wins, and `type` resolves only when
      * `value_type` is absent (`value_type ?? type`).
      */
-    type?: FlagValueType;
-    /** When true, a repeated comma-list flag accumulates values across repeats — parity with core list flags such as `--tags` — instead of the last value winning. Mirrors the core `CliFlagContract.list` field so extension-registered list flags coalesce through the same bootstrap path. */
-    list?: boolean;
-    /** Package-author-friendly alias for ordered list accumulation. Unlike CSV-friendly `list`, commas inside one repeated occurrence remain atomic. Normalized with `list: true` for host registration and contracts. */
-    repeatable?: boolean;
-    /** Default value applied when the flag is omitted. Surfaced to runtime contracts and help output. A `list` flag may default to an array of scalars (e.g. `["a", "b"]`); the array is flattened/coerced like any list value. */
-    default?: string | number | boolean | Array<string | number | boolean>;
+type?: FlagValueType;
+/** When true, a repeated comma-list flag accumulates values across repeats — parity with core list flags such as `--tags` — instead of the last value winning. Mirrors the core `CliFlagContract.list` field so extension-registered list flags coalesce through the same bootstrap path. */
+list?: boolean;
+/** Package-author-friendly alias for ordered list accumulation. Unlike CSV-friendly `list`, commas inside one repeated occurrence remain atomic. Normalized with `list: true` for host registration and contracts. */
+repeatable?: boolean;
+/** Default value applied when the flag is omitted. Surfaced to runtime contracts and help output. A `list` flag may default to an array of scalars (e.g. `["a", "b"]`); the array is flattened/coerced like any list value. */
+default?: string | number | boolean | Array<string | number | boolean>;
 }
 /** Documents the schema field definition payload exchanged by command, SDK, and package integrations. */
 export interface SchemaFieldDefinition {
-    /** Value that configures or reports name for this contract. */
-    name: string;
-    /** Canonical persisted field type shared with `pm schema add-field`. */
-    type: KnownItemFieldType;
-    /** Value that configures or reports optional for this contract. */
-    optional?: boolean;
-    /** Default metadata value applied when the field is absent. */
-    default?: unknown;
-    /** Optional allow-list of accepted metadata values. */
-    values?: unknown[];
+/** Value that configures or reports name for this contract. */
+name: string;
+/** Canonical persisted field type shared with `pm schema add-field`. */
+type: KnownItemFieldType;
+/** Value that configures or reports optional for this contract. */
+optional?: boolean;
+/** Default metadata value applied when the field is absent. */
+default?: unknown;
+/** Optional allow-list of accepted metadata values. */
+values?: unknown[];
 }
 /** Documents the schema item type command option policy definition payload exchanged by command, SDK, and package integrations. */
 export interface SchemaItemTypeCommandOptionPolicyDefinition {
-    /** Value that configures or reports command for this contract. */
-    command: string;
-    /** Value that configures or reports option for this contract. */
-    option: string;
-    /** Whether enabled applies to this operation. */
-    enabled?: boolean;
-    /** Value that configures or reports required for this contract. */
-    required?: boolean;
-    /** Value that configures or reports visible for this contract. */
-    visible?: boolean;
+/** Value that configures or reports command for this contract. */
+command: string;
+/** Value that configures or reports option for this contract. */
+option: string;
+/** Whether enabled applies to this operation. */
+enabled?: boolean;
+/** Value that configures or reports required for this contract. */
+required?: boolean;
+/** Value that configures or reports visible for this contract. */
+visible?: boolean;
 }
 /** Documents the schema item type option definition payload exchanged by command, SDK, and package integrations. */
 export interface SchemaItemTypeOptionDefinition {
-    /** Value that configures or reports key for this contract. */
-    key: string;
-    /** Value that configures or reports values for this contract. */
-    values?: string[];
-    /** Value that configures or reports required for this contract. */
-    required?: boolean;
-    /** Value that configures or reports aliases for this contract. */
-    aliases?: string[];
+/** Value that configures or reports key for this contract. */
+key: string;
+/** Value that configures or reports values for this contract. */
+values?: string[];
+/** Value that configures or reports required for this contract. */
+required?: boolean;
+/** Value that configures or reports aliases for this contract. */
+aliases?: string[];
 }
 /** Documents the schema item type definition payload exchanged by command, SDK, and package integrations. */
 export interface SchemaItemTypeDefinition {
-    /** Value that configures or reports name for this contract. */
-    name: string;
-    /** Value that configures or reports folder for this contract. */
-    folder?: string;
-    /** Value that configures or reports aliases for this contract. */
-    aliases?: string[];
-    /** Human-readable description of the contributed item type. */
-    description?: string;
-    /** Initial status assigned when the contributed item type is created. */
-    default_status?: string;
-    /** Dispatch role inherited by next, context, and automatic claims. Gates track outcomes; human roles require decisions. */
-    execution_role?: "agent" | "human" | "gate";
-    /** Value that configures or reports required create fields for this contract. */
-    required_create_fields?: string[];
-    /** Value that configures or reports required create repeatables for this contract. */
-    required_create_repeatables?: string[];
-    /** Value that configures or reports command option policies for this contract. */
-    command_option_policies?: SchemaItemTypeCommandOptionPolicyDefinition[];
-    /** Value that configures or reports options for this contract. */
-    options?: SchemaItemTypeOptionDefinition[];
-    [key: string]: unknown;
+/** Value that configures or reports name for this contract. */
+name: string;
+/** Value that configures or reports folder for this contract. */
+folder?: string;
+/** Value that configures or reports aliases for this contract. */
+aliases?: string[];
+/** Human-readable description of the contributed item type. */
+description?: string;
+/** Initial status assigned when the contributed item type is created. */
+default_status?: string;
+/** Dispatch role inherited by next, context, and automatic claims. Gates track outcomes; human roles require decisions. */
+execution_role?: "agent" | "human" | "gate";
+/** Value that configures or reports required create fields for this contract. */
+required_create_fields?: string[];
+/** Value that configures or reports required create repeatables for this contract. */
+required_create_repeatables?: string[];
+/** Value that configures or reports command option policies for this contract. */
+command_option_policies?: SchemaItemTypeCommandOptionPolicyDefinition[];
+/** Value that configures or reports options for this contract. */
+options?: SchemaItemTypeOptionDefinition[];
+[key: string]: unknown;
 }
 /** Documents the schema migration run context payload exchanged by command, SDK, and package integrations. */
 export interface SchemaMigrationRunContext {
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
-    /** Value that configures or reports command for this contract. */
-    command: "migration";
-    /** Value that configures or reports layer for this contract. */
-    layer: ExtensionLayer;
-    /** Value that configures or reports extension for this contract. */
-    extension: string;
-    /** Value that configures or reports pm root for this contract. */
-    pm_root: string;
-    /** Lifecycle state reported for status. */
-    status: string;
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Value that configures or reports command for this contract. */
+command: "migration";
+/** Value that configures or reports layer for this contract. */
+layer: ExtensionLayer;
+/** Value that configures or reports extension for this contract. */
+extension: string;
+/** Value that configures or reports pm root for this contract. */
+pm_root: string;
+/** Lifecycle state reported for status. */
+status: string;
 }
 /** Restricts schema migration runner values accepted by command, SDK, and storage contracts. */
 export type SchemaMigrationRunner = (context: SchemaMigrationRunContext) => unknown | Promise<unknown>;
 /** Documents the schema migration definition payload exchanged by command, SDK, and package integrations. */
 export interface SchemaMigrationDefinition {
-    /** Stable identifier used to reference this record across commands and storage. */
-    id?: string;
-    /** Value that configures or reports description for this contract. */
-    description?: string;
-    /** Lifecycle state reported for status. */
-    status?: string;
-    /** Value that configures or reports mandatory for this contract. */
-    mandatory?: boolean;
-    /** Value that configures or reports run for this contract. */
-    run?: SchemaMigrationRunner;
-    [key: string]: unknown;
+/** Stable identifier used to reference this record across commands and storage. */
+id?: string;
+/** Value that configures or reports description for this contract. */
+description?: string;
+/** Lifecycle state reported for status. */
+status?: string;
+/** Value that configures or reports mandatory for this contract. */
+mandatory?: boolean;
+/** Value that configures or reports run for this contract. */
+run?: SchemaMigrationRunner;
+[key: string]: unknown;
 }
 /** Documents the import export context payload exchanged by command, SDK, and package integrations. */
 export interface ImportExportContext extends PortableWorkspaceContext {
-    /** Value that configures or reports registration for this contract. */
-    registration: string;
-    /** Value that configures or reports action for this contract. */
-    action: "import" | "export";
-    /** Value that configures or reports command for this contract. */
-    command: string;
-    /** Value that configures or reports args for this contract. */
-    args: string[];
-    /** Value that configures or reports options for this contract. */
-    options: Record<string, unknown>;
-    /** Value that configures or reports global for this contract. */
-    global: GlobalOptions;
-    /** Value that configures or reports pm root for this contract. */
-    pm_root: string;
-    /** Host-bound SDK runtime for composing PM actions without spawning the CLI. */
-    sdk?: ExtensionCommandSdk;
+/** Value that configures or reports registration for this contract. */
+registration: string;
+/** Value that configures or reports action for this contract. */
+action: "import" | "export";
+/** Value that configures or reports command for this contract. */
+command: string;
+/** Value that configures or reports args for this contract. */
+args: string[];
+/** Value that configures or reports options for this contract. */
+options: Record<string, unknown>;
+/** Value that configures or reports global for this contract. */
+global: GlobalOptions;
+/** Value that configures or reports pm root for this contract. */
+pm_root: string;
+/** Host-bound SDK runtime for composing PM actions without spawning the CLI. */
+sdk?: ExtensionCommandSdk;
 }
 /** Restricts importer values accepted by command, SDK, and storage contracts. */
 export type Importer = (context: ImportExportContext) => unknown | Promise<unknown>;
@@ -931,472 +938,474 @@ export type Exporter = (context: ImportExportContext) => unknown | Promise<unkno
 export type ExtensionSearchMode = "keyword" | "semantic" | "hybrid";
 /** Documents the search provider query context payload exchanged by command, SDK, and package integrations. */
 export interface SearchProviderQueryContext {
-    /** Value that configures or reports query for this contract. */
-    query: string;
-    /** Value that configures or reports mode for this contract. */
-    mode: ExtensionSearchMode;
-    /** Value that configures or reports tokens for this contract. */
-    tokens: string[];
-    /** Value that configures or reports options for this contract. */
-    options: Record<string, unknown>;
-    /** Value that configures or reports settings for this contract. */
-    settings: PmSettings;
-    /** Value that configures or reports documents for this contract. */
-    documents: ItemDocument[];
-    [key: string]: unknown;
+/** Value that configures or reports query for this contract. */
+query: string;
+/** Value that configures or reports mode for this contract. */
+mode: ExtensionSearchMode;
+/** Value that configures or reports tokens for this contract. */
+tokens: string[];
+/** Value that configures or reports options for this contract. */
+options: Record<string, unknown>;
+/** Value that configures or reports settings for this contract. */
+settings: PmSettings;
+/** Value that configures or reports documents for this contract. */
+documents: ItemDocument[];
+[key: string]: unknown;
 }
 /** Documents the search provider hit payload exchanged by command, SDK, and package integrations. */
 export interface SearchProviderHit {
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
-    /** Value that configures or reports score for this contract. */
-    score: number;
-    /** Value that configures or reports matched fields for this contract. */
-    matched_fields?: string[];
-    [key: string]: unknown;
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Value that configures or reports score for this contract. */
+score: number;
+/** Value that configures or reports matched fields for this contract. */
+matched_fields?: string[];
+[key: string]: unknown;
 }
 /** Restricts search provider query result values accepted by command, SDK, and storage contracts. */
 export type SearchProviderQueryResult = SearchProviderHit[] | {
-    hits?: SearchProviderHit[];
+hits?: SearchProviderHit[];
 };
 /** Documents the search provider query expansion context payload exchanged by command, SDK, and package integrations. */
 export interface SearchProviderQueryExpansionContext {
-    /** Value that configures or reports query for this contract. */
-    query: string;
-    /** Value that configures or reports mode for this contract. */
-    mode: Exclude<ExtensionSearchMode, "keyword">;
-    /** Value that configures or reports settings for this contract. */
-    settings: PmSettings;
-    [key: string]: unknown;
+/** Value that configures or reports query for this contract. */
+query: string;
+/** Value that configures or reports mode for this contract. */
+mode: Exclude<ExtensionSearchMode, "keyword">;
+/** Value that configures or reports settings for this contract. */
+settings: PmSettings;
+[key: string]: unknown;
 }
 /** Restricts search provider query expansion result values accepted by command, SDK, and storage contracts. */
 export type SearchProviderQueryExpansionResult = string[] | {
-    queries?: string[];
+queries?: string[];
 };
 /** Documents the search provider rerank candidate payload exchanged by command, SDK, and package integrations. */
 export interface SearchProviderRerankCandidate {
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
-    /** Value that configures or reports text for this contract. */
-    text: string;
-    /** Value that configures or reports score for this contract. */
-    score: number;
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Value that configures or reports text for this contract. */
+text: string;
+/** Value that configures or reports score for this contract. */
+score: number;
 }
 /** Documents the search provider rerank hit payload exchanged by command, SDK, and package integrations. */
 export interface SearchProviderRerankHit {
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
-    /** Value that configures or reports score for this contract. */
-    score: number;
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Value that configures or reports score for this contract. */
+score: number;
 }
 /** Restricts search provider rerank result values accepted by command, SDK, and storage contracts. */
 export type SearchProviderRerankResult = SearchProviderRerankHit[] | {
-    hits?: SearchProviderRerankHit[];
+hits?: SearchProviderRerankHit[];
 };
 /** Documents the search provider rerank context payload exchanged by command, SDK, and package integrations. */
 export interface SearchProviderRerankContext {
-    /** Value that configures or reports query for this contract. */
-    query: string;
-    /** Value that configures or reports mode for this contract. */
-    mode: "hybrid";
-    /** Value that configures or reports model for this contract. */
-    model: string;
-    /** Value that configures or reports top k for this contract. */
-    top_k: number;
-    /** Value that configures or reports settings for this contract. */
-    settings: PmSettings;
-    /** Value that configures or reports candidates for this contract. */
-    candidates: SearchProviderRerankCandidate[];
-    [key: string]: unknown;
+/** Value that configures or reports query for this contract. */
+query: string;
+/** Value that configures or reports mode for this contract. */
+mode: "hybrid";
+/** Value that configures or reports model for this contract. */
+model: string;
+/** Value that configures or reports top k for this contract. */
+top_k: number;
+/** Value that configures or reports settings for this contract. */
+settings: PmSettings;
+/** Value that configures or reports candidates for this contract. */
+candidates: SearchProviderRerankCandidate[];
+[key: string]: unknown;
 }
 /** Documents the search provider embed batch context payload exchanged by command, SDK, and package integrations. */
 export interface SearchProviderEmbedBatchContext {
-    /** Value that configures or reports inputs for this contract. */
-    inputs: string[];
-    /** Value that configures or reports settings for this contract. */
-    settings: PmSettings;
-    /** Value that configures or reports model for this contract. */
-    model: string;
-    [key: string]: unknown;
+/** Value that configures or reports inputs for this contract. */
+inputs: string[];
+/** Value that configures or reports settings for this contract. */
+settings: PmSettings;
+/** Value that configures or reports model for this contract. */
+model: string;
+[key: string]: unknown;
 }
 /** Documents the search provider embed context payload exchanged by command, SDK, and package integrations. */
 export interface SearchProviderEmbedContext {
-    /** Value that configures or reports input for this contract. */
-    input: string;
-    /** Value that configures or reports settings for this contract. */
-    settings: PmSettings;
-    /** Value that configures or reports model for this contract. */
-    model: string;
-    [key: string]: unknown;
+/** Value that configures or reports input for this contract. */
+input: string;
+/** Value that configures or reports settings for this contract. */
+settings: PmSettings;
+/** Value that configures or reports model for this contract. */
+model: string;
+[key: string]: unknown;
 }
 /** Documents the search provider definition payload exchanged by command, SDK, and package integrations. */
 export interface SearchProviderDefinition {
-    /** Value that configures or reports name for this contract. */
-    name: string;
-    /** Value that configures or reports query for this contract. */
-    query?: (context: SearchProviderQueryContext) => SearchProviderQueryResult | Promise<SearchProviderQueryResult>;
-    /** Value that configures or reports query expansion for this contract. */
-    queryExpansion?: (context: SearchProviderQueryExpansionContext) => SearchProviderQueryExpansionResult | Promise<SearchProviderQueryExpansionResult>;
-    /** Value that configures or reports query expansion for this contract. */
-    query_expansion?: (context: SearchProviderQueryExpansionContext) => SearchProviderQueryExpansionResult | Promise<SearchProviderQueryExpansionResult>;
-    /** Value that configures or reports rerank for this contract. */
-    rerank?: (context: SearchProviderRerankContext) => SearchProviderRerankResult | Promise<SearchProviderRerankResult>;
-    /** Value that configures or reports embed batch for this contract. */
-    embedBatch?: (context: SearchProviderEmbedBatchContext) => number[][] | Promise<number[][]>;
-    /** Value that configures or reports embed batch for this contract. */
-    embed_batch?: (context: SearchProviderEmbedBatchContext) => number[][] | Promise<number[][]>;
-    /** Value that configures or reports embed for this contract. */
-    embed?: (context: SearchProviderEmbedContext) => number[] | Promise<number[]>;
-    [key: string]: unknown;
+/** Value that configures or reports name for this contract. */
+name: string;
+/** Value that configures or reports query for this contract. */
+query?: (context: SearchProviderQueryContext) => SearchProviderQueryResult | Promise<SearchProviderQueryResult>;
+/** Value that configures or reports query expansion for this contract. */
+queryExpansion?: (context: SearchProviderQueryExpansionContext) => SearchProviderQueryExpansionResult | Promise<SearchProviderQueryExpansionResult>;
+/** Value that configures or reports query expansion for this contract. */
+query_expansion?: (context: SearchProviderQueryExpansionContext) => SearchProviderQueryExpansionResult | Promise<SearchProviderQueryExpansionResult>;
+/** Value that configures or reports rerank for this contract. */
+rerank?: (context: SearchProviderRerankContext) => SearchProviderRerankResult | Promise<SearchProviderRerankResult>;
+/** Value that configures or reports embed batch for this contract. */
+embedBatch?: (context: SearchProviderEmbedBatchContext) => number[][] | Promise<number[][]>;
+/** Value that configures or reports embed batch for this contract. */
+embed_batch?: (context: SearchProviderEmbedBatchContext) => number[][] | Promise<number[][]>;
+/** Value that configures or reports embed for this contract. */
+embed?: (context: SearchProviderEmbedContext) => number[] | Promise<number[]>;
+[key: string]: unknown;
 }
 /** Documents the vector store query hit payload exchanged by command, SDK, and package integrations. */
 export interface VectorStoreQueryHit {
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
-    /** Value that configures or reports score for this contract. */
-    score: number;
-    /** Value that configures or reports payload for this contract. */
-    payload?: Record<string, unknown>;
-    [key: string]: unknown;
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Value that configures or reports score for this contract. */
+score: number;
+/** Value that configures or reports payload for this contract. */
+payload?: Record<string, unknown>;
+[key: string]: unknown;
 }
 /** Documents the vector store query context payload exchanged by command, SDK, and package integrations. */
 export interface VectorStoreQueryContext {
-    /** Value that configures or reports vector for this contract. */
-    vector: number[];
-    /** Value that configures or reports limit for this contract. */
-    limit: number;
-    /** Value that configures or reports settings for this contract. */
-    settings: PmSettings;
-    [key: string]: unknown;
+/** Value that configures or reports vector for this contract. */
+vector: number[];
+/** Value that configures or reports limit for this contract. */
+limit: number;
+/** Value that configures or reports settings for this contract. */
+settings: PmSettings;
+[key: string]: unknown;
 }
 /** Documents the vector store upsert point payload exchanged by command, SDK, and package integrations. */
 export interface VectorStoreUpsertPoint {
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
-    /** Value that configures or reports vector for this contract. */
-    vector: number[];
-    /** Value that configures or reports payload for this contract. */
-    payload?: Record<string, unknown>;
-    [key: string]: unknown;
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Value that configures or reports vector for this contract. */
+vector: number[];
+/** Value that configures or reports payload for this contract. */
+payload?: Record<string, unknown>;
+[key: string]: unknown;
 }
 /** Documents the vector store upsert context payload exchanged by command, SDK, and package integrations. */
 export interface VectorStoreUpsertContext {
-    /** Value that configures or reports points for this contract. */
-    points: VectorStoreUpsertPoint[];
-    /** Value that configures or reports settings for this contract. */
-    settings: PmSettings;
-    [key: string]: unknown;
+/** Value that configures or reports points for this contract. */
+points: VectorStoreUpsertPoint[];
+/** Value that configures or reports settings for this contract. */
+settings: PmSettings;
+[key: string]: unknown;
 }
 /** Documents the vector store delete context payload exchanged by command, SDK, and package integrations. */
 export interface VectorStoreDeleteContext {
-    /** Value that configures or reports ids for this contract. */
-    ids: string[];
-    /** Value that configures or reports settings for this contract. */
-    settings: PmSettings;
-    [key: string]: unknown;
+/** Value that configures or reports ids for this contract. */
+ids: string[];
+/** Value that configures or reports settings for this contract. */
+settings: PmSettings;
+[key: string]: unknown;
 }
 /** Documents the vector store adapter definition payload exchanged by command, SDK, and package integrations. */
 export interface VectorStoreAdapterDefinition {
-    /** Value that configures or reports name for this contract. */
-    name: string;
-    /** Value that configures or reports query for this contract. */
-    query?: (context: VectorStoreQueryContext) => VectorStoreQueryHit[] | Promise<VectorStoreQueryHit[]>;
-    /** Value that configures or reports upsert for this contract. */
-    upsert?: (context: VectorStoreUpsertContext) => unknown | Promise<unknown>;
-    /** Value that configures or reports delete for this contract. */
-    delete?: (context: VectorStoreDeleteContext) => unknown | Promise<unknown>;
-    [key: string]: unknown;
+/** Value that configures or reports name for this contract. */
+name: string;
+/** Value that configures or reports query for this contract. */
+query?: (context: VectorStoreQueryContext) => VectorStoreQueryHit[] | Promise<VectorStoreQueryHit[]>;
+/** Value that configures or reports upsert for this contract. */
+upsert?: (context: VectorStoreUpsertContext) => unknown | Promise<unknown>;
+/** Value that configures or reports delete for this contract. */
+delete?: (context: VectorStoreDeleteContext) => unknown | Promise<unknown>;
+[key: string]: unknown;
 }
 /** Cost classes let lifecycle gates reject expensive provider work before invoking it. */
 export type AssuranceMeasurementProviderCostClass = "low" | "medium" | "high";
 /** JSON-compatible parameter contract for one provider measurement key. */
 export interface AssuranceMeasurementProviderParameterDefinition {
-    /** Parameter value kind. */
-    type: "string" | "number" | "boolean";
-    /** Whether callers must supply the parameter. */
-    required?: boolean;
-    /** Human-readable parameter intent. */
-    description?: string;
+/** Parameter value kind. */
+type: "string" | "number" | "boolean";
+/** Whether callers must supply the parameter. */
+required?: boolean;
+/** Human-readable parameter intent. */
+description?: string;
 }
 /** Serializable schema for one measurement key owned by a provider. */
 export interface AssuranceMeasurementProviderKeyDefinition {
-    /** Value kind returned by the resolver. */
-    value_type: "number" | "string_set";
-    /** Human-readable metric intent. */
-    description?: string;
-    /** Accepted provider parameters. Unknown parameters are rejected. */
-    parameters?: Record<string, AssuranceMeasurementProviderParameterDefinition>;
+/** Value kind returned by the resolver. */
+value_type: "number" | "string_set";
+/** Human-readable metric intent. */
+description?: string;
+/** Accepted provider parameters. Unknown parameters are rejected. */
+parameters?: Record<string, AssuranceMeasurementProviderParameterDefinition>;
 }
 /** Runtime request supplied to an extension-owned assurance provider. */
 export interface AssuranceMeasurementProviderContext extends PortableWorkspaceContext {
-    /** Provider id selected by the measurement declaration. */
-    provider: string;
-    /** Provider-owned metric key. */
-    key: string;
-    /** Validated provider parameters. */
-    parameters: Record<string, string | number | boolean | null>;
-    /** Gate trigger that authorized this invocation. */
-    trigger: string;
-    /** Tracker root bound to the active command or SDK request. */
-    pm_root: string;
+/** Provider id selected by the measurement declaration. */
+provider: string;
+/** Provider-owned metric key. */
+key: string;
+/** Validated provider parameters. */
+parameters: Record<string, string | number | boolean | null>;
+/** Gate trigger that authorized this invocation. */
+trigger: string;
+/** Tracker root bound to the active command or SDK request. */
+pm_root: string;
 }
 /** Result returned by an extension-owned assurance provider. */
 export interface AssuranceMeasurementProviderResult {
-    /** Finite numeric value or deterministic labelled set. */
-    value: number | string[];
-    /** Population denominator represented by the metric. */
-    population_size: number;
-    /** Abstract compute units charged by the provider. */
-    cost: number;
-    /** Optional stable contributor ids or labels. */
-    contributors?: string[];
+/** Finite numeric value or deterministic labelled set. */
+value: number | string[];
+/** Population denominator represented by the metric. */
+population_size: number;
+/** Abstract compute units charged by the provider. */
+cost: number;
+/** Optional stable contributor ids or labels. */
+contributors?: string[];
 }
 /** Extension registration for an open assurance measurement vocabulary. */
 export interface AssuranceMeasurementProviderDefinition {
-    /** Stable provider id used by measurement declarations and gate allow-lists. */
-    id: string;
-    /** Serializable metric-key schema. */
-    keys: Record<string, AssuranceMeasurementProviderKeyDefinition>;
-    /** Coarse execution cost used by trigger policy before invocation. */
-    cost_class: AssuranceMeasurementProviderCostClass;
-    /** Whether the resolver can access the network. */
-    network: boolean;
-    /** Maximum host wait for one resolver call. */
-    timeout_ms?: number;
-    /** Resolve one declared key. */
-    resolve(context: AssuranceMeasurementProviderContext): AssuranceMeasurementProviderResult | Promise<AssuranceMeasurementProviderResult>;
+/** Stable provider id used by measurement declarations and gate allow-lists. */
+id: string;
+/** Serializable metric-key schema. */
+keys: Record<string, AssuranceMeasurementProviderKeyDefinition>;
+/** Coarse execution cost used by trigger policy before invocation. */
+cost_class: AssuranceMeasurementProviderCostClass;
+/** Whether the resolver can access the network. */
+network: boolean;
+/** Maximum host wait for one resolver call. */
+timeout_ms?: number;
+/** Resolve one declared key. */
+resolve(context: AssuranceMeasurementProviderContext): AssuranceMeasurementProviderResult | Promise<AssuranceMeasurementProviderResult>;
 }
 /** Documents the registered extension command override payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredExtensionCommandOverride {
-    /** Value that configures or reports layer for this contract. */
-    layer: ExtensionLayer;
-    /** Value that configures or reports name for this contract. */
-    name: string;
-    /** Value that configures or reports command for this contract. */
-    command: string;
-    /** Value that configures or reports run for this contract. */
-    run: CommandOverride;
+/** Value that configures or reports layer for this contract. */
+layer: ExtensionLayer;
+/** Value that configures or reports name for this contract. */
+name: string;
+/** Value that configures or reports command for this contract. */
+command: string;
+/** Value that configures or reports run for this contract. */
+run: CommandOverride;
 }
 /** Documents the registered extension command handler payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredExtensionCommandHandler {
-    /** Value that configures or reports layer for this contract. */
-    layer: ExtensionLayer;
-    /** Value that configures or reports name for this contract. */
-    name: string;
-    /** Value that configures or reports command for this contract. */
-    command: string;
-    /** Value that configures or reports run for this contract. */
-    run: CommandHandler;
+/** Value that configures or reports layer for this contract. */
+layer: ExtensionLayer;
+/** Value that configures or reports name for this contract. */
+name: string;
+/** Value that configures or reports command for this contract. */
+command: string;
+/** Value that configures or reports run for this contract. */
+run: CommandHandler;
 }
 /** Documents the registered extension parser override payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredExtensionParserOverride {
-    /** Value that configures or reports layer for this contract. */
-    layer: ExtensionLayer;
-    /** Value that configures or reports name for this contract. */
-    name: string;
-    /** Value that configures or reports command for this contract. */
-    command: string;
-    /** Value that configures or reports run for this contract. */
-    run: ParserOverride;
+/** Value that configures or reports layer for this contract. */
+layer: ExtensionLayer;
+/** Value that configures or reports name for this contract. */
+name: string;
+/** Value that configures or reports command for this contract. */
+command: string;
+/** Value that configures or reports run for this contract. */
+run: ParserOverride;
 }
 /** Documents the registered extension preflight override payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredExtensionPreflightOverride {
-    /** Value that configures or reports layer for this contract. */
-    layer: ExtensionLayer;
-    /** Value that configures or reports name for this contract. */
-    name: string;
-    /** Value that configures or reports run for this contract. */
-    run: PreflightOverride;
-    /** Normalized command paths owned by this preflight override. */
-    commands?: string[];
+/** Value that configures or reports layer for this contract. */
+layer: ExtensionLayer;
+/** Value that configures or reports name for this contract. */
+name: string;
+/** Value that configures or reports run for this contract. */
+run: PreflightOverride;
+/** Normalized command paths owned by this preflight override. */
+commands?: string[];
 }
 /** Documents the registered extension service override payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredExtensionServiceOverride {
-    /** Value that configures or reports layer for this contract. */
-    layer: ExtensionLayer;
-    /** Value that configures or reports name for this contract. */
-    name: string;
-    /** Value that configures or reports service for this contract. */
-    service: ExtensionServiceName;
-    /** Value that configures or reports run for this contract. */
-    run: ServiceOverride;
-    /** Whether the host forbids this callback from handling the service payload. */
-    passThrough?: boolean;
+/** Value that configures or reports layer for this contract. */
+layer: ExtensionLayer;
+/** Value that configures or reports name for this contract. */
+name: string;
+/** Value that configures or reports service for this contract. */
+service: ExtensionServiceName;
+/** Value that configures or reports run for this contract. */
+run: ServiceOverride;
+/** Whether the host forbids this callback from handling the service payload. */
+passThrough?: boolean;
 }
 /** Documents the registered extension renderer override payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredExtensionRendererOverride {
-    /** Value that configures or reports layer for this contract. */
-    layer: ExtensionLayer;
-    /** Value that configures or reports name for this contract. */
-    name: string;
-    /** Value that configures or reports format for this contract. */
-    format: OutputRendererFormat;
-    /** Value that configures or reports run for this contract. */
-    run: RendererOverride;
-    /** Normalized command paths owned by this renderer. */
-    commands?: string[];
-    /** Optional result predicate enforced by the host before invoking the renderer. */
-    resultDiscriminator?: (result: unknown) => boolean;
+/** Value that configures or reports layer for this contract. */
+layer: ExtensionLayer;
+/** Value that configures or reports name for this contract. */
+name: string;
+/** Value that configures or reports format for this contract. */
+format: OutputRendererFormat;
+/** Value that configures or reports run for this contract. */
+run: RendererOverride;
+/** Normalized command paths owned by this renderer. */
+commands?: string[];
+/** Optional result predicate enforced by the host before invoking the renderer. */
+resultDiscriminator?: (result: unknown) => boolean;
 }
 /** Documents the extension command registry payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionCommandRegistry {
-    /** Value that configures or reports overrides for this contract. */
-    overrides: RegisteredExtensionCommandOverride[];
-    /** Value that configures or reports handlers for this contract. */
-    handlers: RegisteredExtensionCommandHandler[];
+/** Value that configures or reports overrides for this contract. */
+overrides: RegisteredExtensionCommandOverride[];
+/** Value that configures or reports handlers for this contract. */
+handlers: RegisteredExtensionCommandHandler[];
 }
 /** Documents the extension parser registry payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionParserRegistry {
-    /** Value that configures or reports overrides for this contract. */
-    overrides: RegisteredExtensionParserOverride[];
+/** Value that configures or reports overrides for this contract. */
+overrides: RegisteredExtensionParserOverride[];
 }
 /** Documents the extension preflight registry payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionPreflightRegistry {
-    /** Value that configures or reports overrides for this contract. */
-    overrides: RegisteredExtensionPreflightOverride[];
+/** Value that configures or reports overrides for this contract. */
+overrides: RegisteredExtensionPreflightOverride[];
 }
 /** Documents the extension service registry payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionServiceRegistry {
-    /** Value that configures or reports overrides for this contract. */
-    overrides: RegisteredExtensionServiceOverride[];
+/** Value that configures or reports overrides for this contract. */
+overrides: RegisteredExtensionServiceOverride[];
 }
 /** Documents the extension renderer registry payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionRendererRegistry {
-    /** Value that configures or reports overrides for this contract. */
-    overrides: RegisteredExtensionRendererOverride[];
+/** Value that configures or reports overrides for this contract. */
+overrides: RegisteredExtensionRendererOverride[];
 }
 /** Documents the registered extension flag definitions payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredExtensionFlagDefinitions {
-    /** Value that configures or reports layer for this contract. */
-    layer: ExtensionLayer;
-    /** Value that configures or reports name for this contract. */
-    name: string;
-    /** Value that configures or reports target command for this contract. */
-    target_command: string;
-    /** Value that configures or reports flags for this contract. */
-    flags: FlagDefinition[];
+/** Value that configures or reports layer for this contract. */
+layer: ExtensionLayer;
+/** Value that configures or reports name for this contract. */
+name: string;
+/** Value that configures or reports target command for this contract. */
+target_command: string;
+/** Value that configures or reports flags for this contract. */
+flags: FlagDefinition[];
 }
 /** Documents the registered extension command definition payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredExtensionCommandDefinition {
-    /** Value that configures or reports layer for this contract. */
-    layer: ExtensionLayer;
-    /** Value that configures or reports name for this contract. */
-    name: string;
-    /** Value that configures or reports source package for this contract. */
-    source_package?: string;
-    /** Value that configures or reports command for this contract. */
-    command: string;
-    /** Value that configures or reports action for this contract. */
-    action: string;
-    /** Value that configures or reports description for this contract. */
-    description?: string;
-    /** Value that configures or reports intent for this contract. */
-    intent?: string;
-    /** Value that configures or reports examples for this contract. */
-    examples: string[];
-    /** Value that configures or reports failure hints for this contract. */
-    failure_hints: string[];
-    /** Value that configures or reports arguments for this contract. */
-    arguments: ExtensionCommandArgumentDefinition[];
-    /** Minimum agent surface tier that should advertise this command. */
-    tier?: "core" | "standard" | "full" | "internal";
-    /** Capability family used by generated agent routing surfaces. */
-    family?: ExtensionCommandCapabilityFamily;
+/** Validated read-only output declaration, snapshotted during activation. */
+read_output?: ExtensionCommandReadOutput;
+/** Value that configures or reports layer for this contract. */
+layer: ExtensionLayer;
+/** Value that configures or reports name for this contract. */
+name: string;
+/** Value that configures or reports source package for this contract. */
+source_package?: string;
+/** Value that configures or reports command for this contract. */
+command: string;
+/** Value that configures or reports action for this contract. */
+action: string;
+/** Value that configures or reports description for this contract. */
+description?: string;
+/** Value that configures or reports intent for this contract. */
+intent?: string;
+/** Value that configures or reports examples for this contract. */
+examples: string[];
+/** Value that configures or reports failure hints for this contract. */
+failure_hints: string[];
+/** Value that configures or reports arguments for this contract. */
+arguments: ExtensionCommandArgumentDefinition[];
+/** Minimum agent surface tier that should advertise this command. */
+tier?: "core" | "standard" | "full" | "internal";
+/** Capability family used by generated agent routing surfaces. */
+family?: ExtensionCommandCapabilityFamily;
 }
 /** Documents the registered extension schema field definitions payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredExtensionSchemaFieldDefinitions {
-    /** Value that configures or reports layer for this contract. */
-    layer: ExtensionLayer;
-    /** Value that configures or reports name for this contract. */
-    name: string;
-    /** Value that configures or reports fields for this contract. */
-    fields: SchemaFieldDefinition[];
+/** Value that configures or reports layer for this contract. */
+layer: ExtensionLayer;
+/** Value that configures or reports name for this contract. */
+name: string;
+/** Value that configures or reports fields for this contract. */
+fields: SchemaFieldDefinition[];
 }
 /** Documents the registered extension schema item type definitions payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredExtensionSchemaItemTypeDefinitions {
-    /** Value that configures or reports layer for this contract. */
-    layer: ExtensionLayer;
-    /** Value that configures or reports name for this contract. */
-    name: string;
-    /** Value that configures or reports types for this contract. */
-    types: SchemaItemTypeDefinition[];
+/** Value that configures or reports layer for this contract. */
+layer: ExtensionLayer;
+/** Value that configures or reports name for this contract. */
+name: string;
+/** Value that configures or reports types for this contract. */
+types: SchemaItemTypeDefinition[];
 }
 /** Relationship ontology definitions contributed by one active extension. */
 export interface RegisteredExtensionRelationshipKindDefinitions {
-    /** Extension layer that owns these definitions. */
-    layer: ExtensionLayer;
-    /** Extension name that owns these definitions. */
-    name: string;
-    /** Validated immutable relationship-kind definitions. */
-    definitions: RelationshipKindDefinition[];
+/** Extension layer that owns these definitions. */
+layer: ExtensionLayer;
+/** Extension name that owns these definitions. */
+name: string;
+/** Validated immutable relationship-kind definitions. */
+definitions: RelationshipKindDefinition[];
 }
 /** Documents the registered extension schema migration definition payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredExtensionSchemaMigrationDefinition {
-    /** Value that configures or reports layer for this contract. */
-    layer: ExtensionLayer;
-    /** Value that configures or reports name for this contract. */
-    name: string;
-    /** Value that configures or reports definition for this contract. */
-    definition: SchemaMigrationDefinition;
-    /** Value that configures or reports runtime definition for this contract. */
-    runtime_definition: SchemaMigrationDefinition;
+/** Value that configures or reports layer for this contract. */
+layer: ExtensionLayer;
+/** Value that configures or reports name for this contract. */
+name: string;
+/** Value that configures or reports definition for this contract. */
+definition: SchemaMigrationDefinition;
+/** Value that configures or reports runtime definition for this contract. */
+runtime_definition: SchemaMigrationDefinition;
 }
 /** Documents the registered extension importer payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredExtensionImporter {
-    /** Value that configures or reports layer for this contract. */
-    layer: ExtensionLayer;
-    /** Value that configures or reports name for this contract. */
-    name: string;
-    /** Value that configures or reports importer for this contract. */
-    importer: string;
+/** Value that configures or reports layer for this contract. */
+layer: ExtensionLayer;
+/** Value that configures or reports name for this contract. */
+name: string;
+/** Value that configures or reports importer for this contract. */
+importer: string;
 }
 /** Documents the registered extension exporter payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredExtensionExporter {
-    /** Value that configures or reports layer for this contract. */
-    layer: ExtensionLayer;
-    /** Value that configures or reports name for this contract. */
-    name: string;
-    /** Value that configures or reports exporter for this contract. */
-    exporter: string;
-    /** Declared artifact channel and normalized receipt policy. */
-    output?: RegisteredExporterArtifactOutputContract;
+/** Value that configures or reports layer for this contract. */
+layer: ExtensionLayer;
+/** Value that configures or reports name for this contract. */
+name: string;
+/** Value that configures or reports exporter for this contract. */
+exporter: string;
+/** Declared artifact channel and normalized receipt policy. */
+output?: RegisteredExporterArtifactOutputContract;
 }
 /** Documents the registered extension search provider payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredExtensionSearchProvider {
-    /** Value that configures or reports layer for this contract. */
-    layer: ExtensionLayer;
-    /** Value that configures or reports name for this contract. */
-    name: string;
-    /** Value that configures or reports definition for this contract. */
-    definition: SearchProviderDefinition;
-    /** Value that configures or reports runtime definition for this contract. */
-    runtime_definition: SearchProviderDefinition;
+/** Value that configures or reports layer for this contract. */
+layer: ExtensionLayer;
+/** Value that configures or reports name for this contract. */
+name: string;
+/** Value that configures or reports definition for this contract. */
+definition: SearchProviderDefinition;
+/** Value that configures or reports runtime definition for this contract. */
+runtime_definition: SearchProviderDefinition;
 }
 /** Documents the registered extension vector store adapter payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredExtensionVectorStoreAdapter {
-    /** Value that configures or reports layer for this contract. */
-    layer: ExtensionLayer;
-    /** Value that configures or reports name for this contract. */
-    name: string;
-    /** Value that configures or reports definition for this contract. */
-    definition: VectorStoreAdapterDefinition;
-    /** Value that configures or reports runtime definition for this contract. */
-    runtime_definition: VectorStoreAdapterDefinition;
+/** Value that configures or reports layer for this contract. */
+layer: ExtensionLayer;
+/** Value that configures or reports name for this contract. */
+name: string;
+/** Value that configures or reports definition for this contract. */
+definition: VectorStoreAdapterDefinition;
+/** Value that configures or reports runtime definition for this contract. */
+runtime_definition: VectorStoreAdapterDefinition;
 }
 /** One validated assurance measurement provider registered by an active extension. */
 export interface RegisteredExtensionAssuranceMeasurementProvider {
-    /** Extension layer owning the provider. */
-    layer: ExtensionLayer;
-    /** Extension name owning the provider. */
-    name: string;
-    /** Whether the owning manifest grants network access. */
-    network_permission: boolean;
-    /** Serializable definition used by doctor, inventory, and policy surfaces. */
-    definition: Omit<AssuranceMeasurementProviderDefinition, "resolve"> & {
-        resolve: "[Function]";
-    };
-    /** Runtime definition containing the executable resolver. */
-    runtime_definition: AssuranceMeasurementProviderDefinition;
+/** Extension layer owning the provider. */
+layer: ExtensionLayer;
+/** Extension name owning the provider. */
+name: string;
+/** Whether the owning manifest grants network access. */
+network_permission: boolean;
+/** Serializable definition used by doctor, inventory, and policy surfaces. */
+definition: Omit<AssuranceMeasurementProviderDefinition, "resolve"> & {
+resolve: "[Function]";
+};
+/** Runtime definition containing the executable resolver. */
+runtime_definition: AssuranceMeasurementProviderDefinition;
 }
 /**
  * Documents a project profile contributed by an extension via
@@ -1410,383 +1419,383 @@ export interface RegisteredExtensionAssuranceMeasurementProvider {
  * `pm profile list/show/apply` for as long as the owning package is active.
  */
 export interface RegisteredExtensionProjectProfile {
-    /** Value that configures or reports layer for this contract. */
-    layer: ExtensionLayer;
-    /** Value that configures or reports name for this contract. */
-    name: string;
-    /** Value that configures or reports profile for this contract. */
-    profile: ProjectProfileDefinition;
+/** Value that configures or reports layer for this contract. */
+layer: ExtensionLayer;
+/** Value that configures or reports name for this contract. */
+name: string;
+/** Value that configures or reports profile for this contract. */
+profile: ProjectProfileDefinition;
 }
 /** Documents the extension registration registry payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionRegistrationRegistry {
-    /** Value that configures or reports commands for this contract. */
-    commands: RegisteredExtensionCommandDefinition[];
-    /** Value that configures or reports flags for this contract. */
-    flags: RegisteredExtensionFlagDefinitions[];
-    /** Value that configures or reports item fields for this contract. */
-    item_fields: RegisteredExtensionSchemaFieldDefinitions[];
-    /** Value that configures or reports item types for this contract. */
-    item_types: RegisteredExtensionSchemaItemTypeDefinitions[];
-    /** Value that configures application-defined relationship semantics. */
-    relationship_kinds: RegisteredExtensionRelationshipKindDefinitions[];
-    /** Value that configures or reports migrations for this contract. */
-    migrations: RegisteredExtensionSchemaMigrationDefinition[];
-    /** Value that configures or reports profiles for this contract. */
-    profiles: RegisteredExtensionProjectProfile[];
-    /** Value that configures or reports importers for this contract. */
-    importers: RegisteredExtensionImporter[];
-    /** Value that configures or reports exporters for this contract. */
-    exporters: RegisteredExtensionExporter[];
-    /** Value that configures or reports search providers for this contract. */
-    search_providers: RegisteredExtensionSearchProvider[];
-    /** Value that configures or reports vector store adapters for this contract. */
-    vector_store_adapters: RegisteredExtensionVectorStoreAdapter[];
-    /** Extension-owned assurance measurement providers. */
-    assurance_providers: RegisteredExtensionAssuranceMeasurementProvider[];
+/** Value that configures or reports commands for this contract. */
+commands: RegisteredExtensionCommandDefinition[];
+/** Value that configures or reports flags for this contract. */
+flags: RegisteredExtensionFlagDefinitions[];
+/** Value that configures or reports item fields for this contract. */
+item_fields: RegisteredExtensionSchemaFieldDefinitions[];
+/** Value that configures or reports item types for this contract. */
+item_types: RegisteredExtensionSchemaItemTypeDefinitions[];
+/** Value that configures application-defined relationship semantics. */
+relationship_kinds: RegisteredExtensionRelationshipKindDefinitions[];
+/** Value that configures or reports migrations for this contract. */
+migrations: RegisteredExtensionSchemaMigrationDefinition[];
+/** Value that configures or reports profiles for this contract. */
+profiles: RegisteredExtensionProjectProfile[];
+/** Value that configures or reports importers for this contract. */
+importers: RegisteredExtensionImporter[];
+/** Value that configures or reports exporters for this contract. */
+exporters: RegisteredExtensionExporter[];
+/** Value that configures or reports search providers for this contract. */
+search_providers: RegisteredExtensionSearchProvider[];
+/** Value that configures or reports vector store adapters for this contract. */
+vector_store_adapters: RegisteredExtensionVectorStoreAdapter[];
+/** Extension-owned assurance measurement providers. */
+assurance_providers: RegisteredExtensionAssuranceMeasurementProvider[];
 }
 /** Documents the extension registration counts payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionRegistrationCounts {
-    /** Value that configures or reports commands for this contract. */
-    commands: number;
-    /** Value that configures or reports flags for this contract. */
-    flags: number;
-    /** Value that configures or reports item fields for this contract. */
-    item_fields: number;
-    /** Value that configures or reports item types for this contract. */
-    item_types: number;
-    /** Number of application-defined relationship kinds. */
-    relationship_kinds?: number;
-    /** Value that configures or reports migrations for this contract. */
-    migrations: number;
-    /** Value that configures or reports profiles for this contract. */
-    profiles: number;
-    /** Value that configures or reports importers for this contract. */
-    importers: number;
-    /** Value that configures or reports exporters for this contract. */
-    exporters: number;
-    /** Value that configures or reports search providers for this contract. */
-    search_providers: number;
-    /** Value that configures or reports vector store adapters for this contract. */
-    vector_store_adapters: number;
-    /** Number of registered assurance measurement providers. */
-    assurance_providers?: number;
+/** Value that configures or reports commands for this contract. */
+commands: number;
+/** Value that configures or reports flags for this contract. */
+flags: number;
+/** Value that configures or reports item fields for this contract. */
+item_fields: number;
+/** Value that configures or reports item types for this contract. */
+item_types: number;
+/** Number of application-defined relationship kinds. */
+relationship_kinds?: number;
+/** Value that configures or reports migrations for this contract. */
+migrations: number;
+/** Value that configures or reports profiles for this contract. */
+profiles: number;
+/** Value that configures or reports importers for this contract. */
+importers: number;
+/** Value that configures or reports exporters for this contract. */
+exporters: number;
+/** Value that configures or reports search providers for this contract. */
+search_providers: number;
+/** Value that configures or reports vector store adapters for this contract. */
+vector_store_adapters: number;
+/** Number of registered assurance measurement providers. */
+assurance_providers?: number;
 }
 /** Read-only identity an extension's `activate(api)` receives about itself, so authors can emit self-identifying logs, gate on their own version, and build better error messages without re-reading the on-disk manifest or duplicating metadata in-module. Exposed as `api.extension`. */
 export interface ExtensionSelfIdentity {
-    /** Value that configures or reports name for this contract. */
-    readonly name: string;
-    /** Value that configures or reports layer for this contract. */
-    readonly layer: ExtensionLayer;
-    /** Value that configures or reports version for this contract. */
-    readonly version: string;
-    /** Value that configures or reports capabilities for this contract. */
-    readonly capabilities: readonly ExtensionCapability[];
-    /** Value that configures or reports pm min version for this contract. */
-    readonly pm_min_version?: string;
-    /** Value that configures or reports pm max version for this contract. */
-    readonly pm_max_version?: string;
-    /** Value that configures or reports source package for this contract. */
-    readonly source_package?: string;
+/** Value that configures or reports name for this contract. */
+readonly name: string;
+/** Value that configures or reports layer for this contract. */
+readonly layer: ExtensionLayer;
+/** Value that configures or reports version for this contract. */
+readonly version: string;
+/** Value that configures or reports capabilities for this contract. */
+readonly capabilities: readonly ExtensionCapability[];
+/** Value that configures or reports pm min version for this contract. */
+readonly pm_min_version?: string;
+/** Value that configures or reports pm max version for this contract. */
+readonly pm_max_version?: string;
+/** Value that configures or reports source package for this contract. */
+readonly source_package?: string;
 }
 /** Documents the extension api payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionApi {
-    /** Read-only identity of the extension this `api` was created for. */
-    readonly extension: ExtensionSelfIdentity;
-    /** Value that configures or reports register command for this contract. */
-    registerCommand(command: string, override: CommandOverride): void;
-    /** Value that configures or reports register command for this contract. */
-    registerCommand(definition: CommandDefinition): void;
-    /** Value that configures or reports register parser for this contract. */
-    registerParser(command: string, override: ParserOverride): void;
-    /** Value that configures or reports register preflight for this contract. */
-    registerPreflight(override: PreflightOverride | ScopedPreflightOverrideDefinition): void;
-    /** Value that configures or reports register service for this contract. */
-    registerService(service: ExtensionServiceName, override: ServiceOverride, ownership?: ServiceOverrideOwnership): void;
-    /** Value that configures or reports register flags for this contract. */
-    registerFlags(targetCommand: string, flags: FlagDefinition[]): void;
-    /** Value that configures or reports register item fields for this contract. */
-    registerItemFields(fields: SchemaFieldDefinition[]): void;
-    /** Value that configures or reports register item types for this contract. */
-    registerItemTypes(types: SchemaItemTypeDefinition[]): void;
-    /** Register versioned relationship semantics consumed by every graph surface. */
-    registerRelationshipKinds(definitions: RelationshipKindDefinition[]): void;
-    /** Value that configures or reports register migration for this contract. */
-    registerMigration(definition: SchemaMigrationDefinition): void;
-    /** Value that configures or reports register profile for this contract. */
-    registerProfile(profile: ProjectProfileRegistrationInput): void;
-    /** Value that configures or reports register renderer for this contract. */
-    registerRenderer(format: OutputRendererFormat, renderer: RendererOverride, ownership?: RendererOverrideOwnership): void;
-    /** Value that configures or reports register importer for this contract. */
-    registerImporter(name: string, importer: Importer, options?: ImportExportRegistrationOptions): void;
-    /** Value that configures or reports register exporter for this contract. */
-    registerExporter(name: string, exporter: Exporter, options?: ExporterRegistrationOptions): void;
-    /** Value that configures or reports register search provider for this contract. */
-    registerSearchProvider(provider: SearchProviderDefinition): void;
-    /** Value that configures or reports register vector store adapter for this contract. */
-    registerVectorStoreAdapter(adapter: VectorStoreAdapterDefinition): void;
-    /** Register an assurance measurement provider through the services capability. */
-    registerAssuranceMeasurementProvider(provider: AssuranceMeasurementProviderDefinition): void;
-    /** Value that configures or reports hooks for this contract. */
-    hooks: {
-        beforeCommand(hook: BeforeCommandHook): void;
-        beforeMutation(hook: BeforeMutationHook): void;
-        afterCommand(hook: AfterCommandHook): void;
-        onWrite(hook: OnWriteHook): void;
-        onRead(hook: OnReadHook): void;
-        onIndex(hook: OnIndexHook): void;
-    };
+/** Read-only identity of the extension this `api` was created for. */
+readonly extension: ExtensionSelfIdentity;
+/** Value that configures or reports register command for this contract. */
+registerCommand(command: string, override: CommandOverride): void;
+/** Value that configures or reports register command for this contract. */
+registerCommand(definition: CommandDefinition): void;
+/** Value that configures or reports register parser for this contract. */
+registerParser(command: string, override: ParserOverride): void;
+/** Value that configures or reports register preflight for this contract. */
+registerPreflight(override: PreflightOverride | ScopedPreflightOverrideDefinition): void;
+/** Value that configures or reports register service for this contract. */
+registerService(service: ExtensionServiceName, override: ServiceOverride, ownership?: ServiceOverrideOwnership): void;
+/** Value that configures or reports register flags for this contract. */
+registerFlags(targetCommand: string, flags: FlagDefinition[]): void;
+/** Value that configures or reports register item fields for this contract. */
+registerItemFields(fields: SchemaFieldDefinition[]): void;
+/** Value that configures or reports register item types for this contract. */
+registerItemTypes(types: SchemaItemTypeDefinition[]): void;
+/** Register versioned relationship semantics consumed by every graph surface. */
+registerRelationshipKinds(definitions: RelationshipKindDefinition[]): void;
+/** Value that configures or reports register migration for this contract. */
+registerMigration(definition: SchemaMigrationDefinition): void;
+/** Value that configures or reports register profile for this contract. */
+registerProfile(profile: ProjectProfileRegistrationInput): void;
+/** Value that configures or reports register renderer for this contract. */
+registerRenderer(format: OutputRendererFormat, renderer: RendererOverride, ownership?: RendererOverrideOwnership): void;
+/** Value that configures or reports register importer for this contract. */
+registerImporter(name: string, importer: Importer, options?: ImportExportRegistrationOptions): void;
+/** Value that configures or reports register exporter for this contract. */
+registerExporter(name: string, exporter: Exporter, options?: ExporterRegistrationOptions): void;
+/** Value that configures or reports register search provider for this contract. */
+registerSearchProvider(provider: SearchProviderDefinition): void;
+/** Value that configures or reports register vector store adapter for this contract. */
+registerVectorStoreAdapter(adapter: VectorStoreAdapterDefinition): void;
+/** Register an assurance measurement provider through the services capability. */
+registerAssuranceMeasurementProvider(provider: AssuranceMeasurementProviderDefinition): void;
+/** Value that configures or reports hooks for this contract. */
+hooks: {
+beforeCommand(hook: BeforeCommandHook): void;
+beforeMutation(hook: BeforeMutationHook): void;
+afterCommand(hook: AfterCommandHook): void;
+onWrite(hook: OnWriteHook): void;
+onRead(hook: OnReadHook): void;
+onIndex(hook: OnIndexHook): void;
+};
 }
 /** Documents the failed extension activation payload exchanged by command, SDK, and package integrations. */
 export interface FailedExtensionActivation {
-    /** Value that configures or reports layer for this contract. */
-    layer: ExtensionLayer;
-    /** Value that configures or reports name for this contract. */
-    name: string;
-    /** Filesystem path used for entry resolution. */
-    entry_path: string;
-    /** Value that configures or reports error for this contract. */
-    error: string;
-    /** Value that configures or reports trace for this contract. */
-    trace?: ExtensionActivationFailureTrace;
+/** Value that configures or reports layer for this contract. */
+layer: ExtensionLayer;
+/** Value that configures or reports name for this contract. */
+name: string;
+/** Filesystem path used for entry resolution. */
+entry_path: string;
+/** Value that configures or reports error for this contract. */
+error: string;
+/** Value that configures or reports trace for this contract. */
+trace?: ExtensionActivationFailureTrace;
 }
 /** Documents the extension activation failure trace payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionActivationFailureTrace {
-    /** Value that configures or reports method for this contract. */
-    method: string;
-    /** `-1` means the failure happened before a numbered registration was accepted. */
-    registration_index: number;
-    /** Value that configures or reports command for this contract. */
-    command?: string;
-    /** Value that configures or reports capability for this contract. */
-    capability?: ExtensionCapability;
-    /** Value that configures or reports missing capability for this contract. */
-    missing_capability?: ExtensionCapability;
-    /** Value that configures or reports expected schema for this contract. */
-    expected_schema: string;
-    /** Value that configures or reports received for this contract. */
-    received?: unknown;
-    /** Value that configures or reports hint for this contract. */
-    hint?: string;
+/** Value that configures or reports method for this contract. */
+method: string;
+/** `-1` means the failure happened before a numbered registration was accepted. */
+registration_index: number;
+/** Value that configures or reports command for this contract. */
+command?: string;
+/** Value that configures or reports capability for this contract. */
+capability?: ExtensionCapability;
+/** Value that configures or reports missing capability for this contract. */
+missing_capability?: ExtensionCapability;
+/** Value that configures or reports expected schema for this contract. */
+expected_schema: string;
+/** Value that configures or reports received for this contract. */
+received?: unknown;
+/** Value that configures or reports hint for this contract. */
+hint?: string;
 }
 /** Documents the extension activation result payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionActivationResult {
-    /** Value that configures or reports hooks for this contract. */
-    hooks: ExtensionHookRegistry;
-    /** Value that configures or reports commands for this contract. */
-    commands: ExtensionCommandRegistry;
-    /** Value that configures or reports parsers for this contract. */
-    parsers: ExtensionParserRegistry;
-    /** Value that configures or reports preflight for this contract. */
-    preflight: ExtensionPreflightRegistry;
-    /** Value that configures or reports services for this contract. */
-    services: ExtensionServiceRegistry;
-    /** Value that configures or reports renderers for this contract. */
-    renderers: ExtensionRendererRegistry;
-    /** Value that configures or reports registrations for this contract. */
-    registrations: ExtensionRegistrationRegistry;
-    /** Value that configures or reports failed for this contract. */
-    failed: FailedExtensionActivation[];
-    /** Value that configures or reports warnings for this contract. */
-    warnings: string[];
-    /** Value that configures or reports hook counts for this contract. */
-    hook_counts: {
-        before_command: number;
-        before_mutation: number;
-        after_command: number;
-        on_write: number;
-        on_read: number;
-        on_index: number;
-    };
-    /** Number of command override entries represented by this result. */
-    command_override_count: number;
-    /** Number of command handler entries represented by this result. */
-    command_handler_count: number;
-    /** Number of parser override entries represented by this result. */
-    parser_override_count: number;
-    /** Number of preflight override entries represented by this result. */
-    preflight_override_count: number;
-    /** Number of service override entries represented by this result. */
-    service_override_count: number;
-    /** Number of renderer override entries represented by this result. */
-    renderer_override_count: number;
-    /** Value that configures or reports registration counts for this contract. */
-    registration_counts: ExtensionRegistrationCounts;
+/** Value that configures or reports hooks for this contract. */
+hooks: ExtensionHookRegistry;
+/** Value that configures or reports commands for this contract. */
+commands: ExtensionCommandRegistry;
+/** Value that configures or reports parsers for this contract. */
+parsers: ExtensionParserRegistry;
+/** Value that configures or reports preflight for this contract. */
+preflight: ExtensionPreflightRegistry;
+/** Value that configures or reports services for this contract. */
+services: ExtensionServiceRegistry;
+/** Value that configures or reports renderers for this contract. */
+renderers: ExtensionRendererRegistry;
+/** Value that configures or reports registrations for this contract. */
+registrations: ExtensionRegistrationRegistry;
+/** Value that configures or reports failed for this contract. */
+failed: FailedExtensionActivation[];
+/** Value that configures or reports warnings for this contract. */
+warnings: string[];
+/** Value that configures or reports hook counts for this contract. */
+hook_counts: {
+before_command: number;
+before_mutation: number;
+after_command: number;
+on_write: number;
+on_read: number;
+on_index: number;
+};
+/** Number of command override entries represented by this result. */
+command_override_count: number;
+/** Number of command handler entries represented by this result. */
+command_handler_count: number;
+/** Number of parser override entries represented by this result. */
+parser_override_count: number;
+/** Number of preflight override entries represented by this result. */
+preflight_override_count: number;
+/** Number of service override entries represented by this result. */
+service_override_count: number;
+/** Number of renderer override entries represented by this result. */
+renderer_override_count: number;
+/** Value that configures or reports registration counts for this contract. */
+registration_counts: ExtensionRegistrationCounts;
 }
 /** Documents the extension candidate payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionCandidate {
-    /** Value that configures or reports layer for this contract. */
-    layer: ExtensionLayer;
-    /** Value that configures or reports directory for this contract. */
-    directory: string;
-    /** Filesystem path used for manifest resolution. */
-    manifest_path: string;
-    /** Filesystem path used for entry resolution. */
-    entry_path: string;
-    /** Declarative package manifest consumed by the extension loader. */
-    manifest: ExtensionManifest;
-    /** Value that configures or reports source package for this contract. */
-    source_package?: string;
-    /** Install-source identities that can resolve this extension through package lifecycle commands. */
-    source_aliases?: string[];
-    /** Persisted contribution inventory resolved without importing the module. */
-    contributions?: ExtensionContributionInventory;
+/** Value that configures or reports layer for this contract. */
+layer: ExtensionLayer;
+/** Value that configures or reports directory for this contract. */
+directory: string;
+/** Filesystem path used for manifest resolution. */
+manifest_path: string;
+/** Filesystem path used for entry resolution. */
+entry_path: string;
+/** Declarative package manifest consumed by the extension loader. */
+manifest: ExtensionManifest;
+/** Value that configures or reports source package for this contract. */
+source_package?: string;
+/** Install-source identities that can resolve this extension through package lifecycle commands. */
+source_aliases?: string[];
+/** Persisted contribution inventory resolved without importing the module. */
+contributions?: ExtensionContributionInventory;
 }
 /** Documents the extension layer scan result payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionLayerScanResult {
-    /** Value that configures or reports diagnostics for this contract. */
-    diagnostics: ExtensionDiagnostic[];
-    /** Value that configures or reports warnings for this contract. */
-    warnings: string[];
-    /** Value that configures or reports candidates for this contract. */
-    candidates: ExtensionCandidate[];
+/** Value that configures or reports diagnostics for this contract. */
+diagnostics: ExtensionDiagnostic[];
+/** Value that configures or reports warnings for this contract. */
+warnings: string[];
+/** Value that configures or reports candidates for this contract. */
+candidates: ExtensionCandidate[];
 }
 /** Documents the scanned extension directory payload exchanged by command, SDK, and package integrations. */
 export interface ScannedExtensionDirectory {
-    /** Value that configures or reports diagnostic for this contract. */
-    diagnostic: ExtensionDiagnostic;
-    /** Value that configures or reports warnings for this contract. */
-    warnings: string[];
-    /** Value that configures or reports candidate for this contract. */
-    candidate: ExtensionCandidate | null;
+/** Value that configures or reports diagnostic for this contract. */
+diagnostic: ExtensionDiagnostic;
+/** Value that configures or reports warnings for this contract. */
+warnings: string[];
+/** Value that configures or reports candidate for this contract. */
+candidate: ExtensionCandidate | null;
 }
 /** Documents the legacy extension capability alias mapping payload exchanged by command, SDK, and package integrations. */
 export interface LegacyExtensionCapabilityAliasMapping {
-    /** Value that configures or reports alias for this contract. */
-    alias: string;
-    /** Value that configures or reports target for this contract. */
-    target: ExtensionCapability;
+/** Value that configures or reports alias for this contract. */
+alias: string;
+/** Value that configures or reports target for this contract. */
+target: ExtensionCapability;
 }
 /** Documents the discover extensions options payload exchanged by command, SDK, and package integrations. */
 export interface DiscoverExtensionsOptions {
-    /** Value that configures or reports pm root for this contract. */
-    pmRoot: string;
-    /** Value that configures or reports settings for this contract. */
-    settings: PmSettings;
-    /** Value that configures or reports cwd for this contract. */
-    cwd?: string;
-    /** Value that configures or reports no extensions for this contract. */
-    noExtensions?: boolean;
-    /** Value that configures or reports ignore global extensions for this contract. */
-    ignoreGlobalExtensions?: boolean;
-    /** Value that configures or reports reload token for this contract. */
-    reload_token?: string;
-    /** Value that configures or reports cache bust for this contract. */
-    cache_bust?: boolean;
-    /** Optional import-stage filter. Discovery still reports the full effective set, but `loadExtensions` imports only entries accepted by this predicate. */
-    extensionFilter?: (extension: EffectiveExtension) => boolean;
-    /** Optional temporary root where each extension is copied before import, giving reinstall verification a fresh absolute module graph rather than cache-busting only the entry module URL. The caller owns cleanup after activation completes. */
-    module_graph_snapshot_root?: string;
+/** Value that configures or reports pm root for this contract. */
+pmRoot: string;
+/** Value that configures or reports settings for this contract. */
+settings: PmSettings;
+/** Value that configures or reports cwd for this contract. */
+cwd?: string;
+/** Value that configures or reports no extensions for this contract. */
+noExtensions?: boolean;
+/** Value that configures or reports ignore global extensions for this contract. */
+ignoreGlobalExtensions?: boolean;
+/** Value that configures or reports reload token for this contract. */
+reload_token?: string;
+/** Value that configures or reports cache bust for this contract. */
+cache_bust?: boolean;
+/** Optional import-stage filter. Discovery still reports the full effective set, but `loadExtensions` imports only entries accepted by this predicate. */
+extensionFilter?: (extension: EffectiveExtension) => boolean;
+/** Optional temporary root where each extension is copied before import, giving reinstall verification a fresh absolute module graph rather than cache-busting only the entry module URL. The caller owns cleanup after activation completes. */
+module_graph_snapshot_root?: string;
 }
 /** Documents the activatable extension payload exchanged by command, SDK, and package integrations. */
 export interface ActivatableExtension {
-    /** Registers this package's commands, actions, and runtime hooks with the host. */
-    activate: (api: ExtensionApi) => void | Promise<void>;
-    /** Optional teardown lifecycle hook, analogous to VS Code's `deactivate` export. Invoked when the host tears the extension down — on long-running MCP-server reload between requests, or via the `deactivateExtensions` primitive — so an extension can close connections, clear timers, and release buffers it opened during `activate`. */
-    deactivate?: () => void | Promise<void>;
+/** Registers this package's commands, actions, and runtime hooks with the host. */
+activate: (api: ExtensionApi) => void | Promise<void>;
+/** Optional teardown lifecycle hook, analogous to VS Code's `deactivate` export. Invoked when the host tears the extension down — on long-running MCP-server reload between requests, or via the `deactivateExtensions` primitive — so an extension can close connections, clear timers, and release buffers it opened during `activate`. */
+deactivate?: () => void | Promise<void>;
 }
 /** Documents the extension deactivation failure payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionDeactivationFailure {
-    /** Value that configures or reports layer for this contract. */
-    layer: ExtensionLayer;
-    /** Value that configures or reports name for this contract. */
-    name: string;
-    /** Value that configures or reports error for this contract. */
-    error: string;
+/** Value that configures or reports layer for this contract. */
+layer: ExtensionLayer;
+/** Value that configures or reports name for this contract. */
+name: string;
+/** Value that configures or reports error for this contract. */
+error: string;
 }
 /** Documents the extension deactivation options payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionDeactivationOptions {
-    /** Maximum time to wait for each extension's `deactivate` hook. Defaults to 5000ms so a hanging teardown cannot block host shutdown or reload. Set to 0 or Infinity only when the host intentionally wants to wait indefinitely. */
-    deactivate_timeout_ms?: number;
+/** Maximum time to wait for each extension's `deactivate` hook. Defaults to 5000ms so a hanging teardown cannot block host shutdown or reload. Set to 0 or Infinity only when the host intentionally wants to wait indefinitely. */
+deactivate_timeout_ms?: number;
 }
 /** Documents the extension deactivation result payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionDeactivationResult {
-    /** Count of loaded extensions whose `deactivate` hook ran without throwing. */
-    deactivated: number;
-    /** Value that configures or reports warnings for this contract. */
-    warnings: string[];
-    /** Value that configures or reports failed for this contract. */
-    failed: ExtensionDeactivationFailure[];
+/** Count of loaded extensions whose `deactivate` hook ran without throwing. */
+deactivated: number;
+/** Value that configures or reports warnings for this contract. */
+warnings: string[];
+/** Value that configures or reports failed for this contract. */
+failed: ExtensionDeactivationFailure[];
 }
 /** Documents the service override result payload exchanged by command, SDK, and package integrations. */
 export interface ServiceOverrideResult {
-    /** Value that configures or reports handled for this contract. */
-    handled: boolean;
-    /** Value that configures or reports result for this contract. */
-    result: unknown;
-    /** Value that configures or reports warnings for this contract. */
-    warnings: string[];
+/** Value that configures or reports handled for this contract. */
+handled: boolean;
+/** Value that configures or reports result for this contract. */
+result: unknown;
+/** Value that configures or reports warnings for this contract. */
+warnings: string[];
 }
 /** Documents the command override result payload exchanged by command, SDK, and package integrations. */
 export interface CommandOverrideResult {
-    /** Value that configures or reports overridden for this contract. */
-    overridden: boolean;
-    /** Value that configures or reports result for this contract. */
-    result: unknown;
-    /** Value that configures or reports warnings for this contract. */
-    warnings: string[];
+/** Value that configures or reports overridden for this contract. */
+overridden: boolean;
+/** Value that configures or reports result for this contract. */
+result: unknown;
+/** Value that configures or reports warnings for this contract. */
+warnings: string[];
 }
 /** Documents the command handler result payload exchanged by command, SDK, and package integrations. */
 export interface CommandHandlerResult {
-    /** Value that configures or reports handled for this contract. */
-    handled: boolean;
-    /** Value that configures or reports result for this contract. */
-    result: unknown;
-    /** Value that configures or reports warnings for this contract. */
-    warnings: string[];
-    /** Human-readable, single-line, length-bounded message describing why an extension command handler failed. Surfaced to the user/CI so the real cause (e.g. "Changelog is out of date: CHANGELOG.md") is visible instead of only the opaque `extension_command_handler_failed` warning code. */
-    errorMessage?: string;
-    /** Validated non-zero process status requested by a structured handler result. */
-    exitCode?: number;
-    /** Stable extension-provided error code preserved for structured recovery. */
-    errorCode?: string;
-    /** Actionable extension-provided recovery text preserved by the host. */
-    remediation?: string;
+/** Value that configures or reports handled for this contract. */
+handled: boolean;
+/** Value that configures or reports result for this contract. */
+result: unknown;
+/** Value that configures or reports warnings for this contract. */
+warnings: string[];
+/** Human-readable, single-line, length-bounded message describing why an extension command handler failed. Surfaced to the user/CI so the real cause (e.g. "Changelog is out of date: CHANGELOG.md") is visible instead of only the opaque `extension_command_handler_failed` warning code. */
+errorMessage?: string;
+/** Validated non-zero process status requested by a structured handler result. */
+exitCode?: number;
+/** Stable extension-provided error code preserved for structured recovery. */
+errorCode?: string;
+/** Actionable extension-provided recovery text preserved by the host. */
+remediation?: string;
 }
 /** Documents the parser override result payload exchanged by command, SDK, and package integrations. */
 export interface ParserOverrideResult {
-    /** Value that configures or reports overridden for this contract. */
-    overridden: boolean;
-    /** Value that configures or reports context for this contract. */
-    context: CommandHandlerContext;
-    /** Value that configures or reports warnings for this contract. */
-    warnings: string[];
+/** Value that configures or reports overridden for this contract. */
+overridden: boolean;
+/** Value that configures or reports context for this contract. */
+context: CommandHandlerContext;
+/** Value that configures or reports warnings for this contract. */
+warnings: string[];
 }
 /** Documents the preflight override result payload exchanged by command, SDK, and package integrations. */
 export interface PreflightOverrideResult {
-    /** Value that configures or reports overridden for this contract. */
-    overridden: boolean;
-    /** Value that configures or reports context for this contract. */
-    context: CommandHandlerContext;
-    /** Value that configures or reports decision for this contract. */
-    decision: PreflightRuntimeDecision;
-    /** Value that configures or reports warnings for this contract. */
-    warnings: string[];
+/** Value that configures or reports overridden for this contract. */
+overridden: boolean;
+/** Value that configures or reports context for this contract. */
+context: CommandHandlerContext;
+/** Value that configures or reports decision for this contract. */
+decision: PreflightRuntimeDecision;
+/** Value that configures or reports warnings for this contract. */
+warnings: string[];
 }
 /** Documents the renderer override result payload exchanged by command, SDK, and package integrations. */
 export interface RendererOverrideResult {
-    /** Value that configures or reports overridden for this contract. */
-    overridden: boolean;
-    /** Value that configures or reports rendered for this contract. */
-    rendered: string | null;
-    /** Value that configures or reports warnings for this contract. */
-    warnings: string[];
+/** Value that configures or reports overridden for this contract. */
+overridden: boolean;
+/** Value that configures or reports rendered for this contract. */
+rendered: string | null;
+/** Value that configures or reports warnings for this contract. */
+warnings: string[];
 }
 /** Documents the unknown extension capability warning details payload exchanged by command, SDK, and package integrations. */
 export interface UnknownExtensionCapabilityWarningDetails {
-    /** Value that configures or reports layer for this contract. */
-    layer: ExtensionLayer;
-    /** Value that configures or reports name for this contract. */
-    name: string;
-    /** Value that configures or reports capability for this contract. */
-    capability: string;
-    /** Value that configures or reports allowed capabilities for this contract. */
-    allowed_capabilities: string[];
-    /** Value that configures or reports capability contract version for this contract. */
-    capability_contract_version: number;
-    /** Value that configures or reports suggested capability for this contract. */
-    suggested_capability?: string;
-    /** Value that configures or reports suggestion source for this contract. */
-    suggestion_source?: "legacy_alias" | "nearest_match";
-    /** Value that configures or reports legacy alias target for this contract. */
-    legacy_alias_target?: string;
+/** Value that configures or reports layer for this contract. */
+layer: ExtensionLayer;
+/** Value that configures or reports name for this contract. */
+name: string;
+/** Value that configures or reports capability for this contract. */
+capability: string;
+/** Value that configures or reports allowed capabilities for this contract. */
+allowed_capabilities: string[];
+/** Value that configures or reports capability contract version for this contract. */
+capability_contract_version: number;
+/** Value that configures or reports suggested capability for this contract. */
+suggested_capability?: string;
+/** Value that configures or reports suggestion source for this contract. */
+suggestion_source?: "legacy_alias" | "nearest_match";
+/** Value that configures or reports legacy alias target for this contract. */
+legacy_alias_target?: string;
 }