@unbrained/pm-cli 2026.10.12 → 2026.10.14

package/dist/sdk/testing.d.ts

@@ -14,6 +14,10 @@ import type { ExtensionSurfaceMarkdownOptions } from "../core/extensions/activat
 import type { ExtensionBlueprint, ExtensionBlueprintLintCode, ExtensionBlueprintLintFinding, ExtensionBlueprintLintResult, ExtensionBlueprintLintSeverity, ExtensionManifestCompatibilityManifest, ExtensionManifestCompatibilityResult, ExtensionManifestCompatibilityTarget, ExtensionPreflightReport, LintExtensionBlueprintOptions, PreflightExtensionOptions } from "./compose.js";
 import type { GlobalOptions } from "../core/shared/command-types.js";
 import type { PmPackageManifest, PmPackageResourceKind } from "../core/packages/manifest.js";
+/** Host-pinned TOON codecs for semantic package-output assertions without deep imports. */
+export { decode as decodeToon, encode as encodeToon } from "@toon-format/toon";
+/** Codec options and JSON values owned by the exact implementation used by the host. */
+export type { DecodeOptions as ToonDecodeOptions, EncodeOptions as ToonEncodeOptions, JsonValue as ToonJsonValue } from "@toon-format/toon";
 export { describeExtensionActivation, renderExtensionSurfaceMarkdown };
 export type { DescribeExtensionActivationOptions, ExtensionActivationSummary, } from "../core/extensions/activation-summary.js";
 export type { ExtensionSurfaceMarkdownOptions } from "../core/extensions/activation-summary-markdown.js";
@@ -21,54 +25,54 @@ export { describeExtensionBlueprint, lintExtensionBlueprint };
 export type { ExtensionBlueprint, ExtensionBlueprintLintCode, ExtensionBlueprintLintFinding, ExtensionBlueprintLintResult, ExtensionBlueprintLintSeverity, LintExtensionBlueprintOptions, };
 /** Documents the activate extension for test options payload exchanged by command, SDK, and package integrations. */
 export interface ActivateExtensionForTestOptions {
-    /** Value that configures or reports name for this contract. */
-    name?: string;
-    /** Value that configures or reports layer for this contract. */
-    layer?: ExtensionLayer;
-    /** Value that configures or reports capabilities for this contract. */
-    capabilities?: readonly ExtensionCapability[];
-    /** Value that configures or reports policy for this contract. */
-    policy?: ExtensionGovernancePolicy;
+/** Value that configures or reports name for this contract. */
+name?: string;
+/** Value that configures or reports layer for this contract. */
+layer?: ExtensionLayer;
+/** Value that configures or reports capabilities for this contract. */
+capabilities?: readonly ExtensionCapability[];
+/** Value that configures or reports policy for this contract. */
+policy?: ExtensionGovernancePolicy;
 }
 /** Documents the deactivate extension for test options payload exchanged by command, SDK, and package integrations. */
 export interface DeactivateExtensionForTestOptions {
-    /** Overrides the in-memory extension name (defaults to `manifest.name` or `"test-extension"`). */
-    name?: string;
-    /** Overrides the layer recorded for the in-memory extension (defaults to `"project"`). */
-    layer?: ExtensionLayer;
-    /** Activation result returned by `activateExtensionForTest`. When provided, an extension whose `activate` failed is skipped — mirroring the host teardown contract that never deactivates a never-initialized extension. Pass the same `name`/`layer` to both helpers so the skip key matches. */
-    activation?: Pick<ExtensionActivationResult, "failed">;
-    /** Per-hook teardown bound, forwarded as `deactivate_timeout_ms`. Use `0` (or `Infinity`) to wait indefinitely; omit to keep the host default. */
-    deactivateTimeoutMs?: number;
+/** Overrides the in-memory extension name (defaults to `manifest.name` or `"test-extension"`). */
+name?: string;
+/** Overrides the layer recorded for the in-memory extension (defaults to `"project"`). */
+layer?: ExtensionLayer;
+/** Activation result returned by `activateExtensionForTest`. When provided, an extension whose `activate` failed is skipped — mirroring the host teardown contract that never deactivates a never-initialized extension. Pass the same `name`/`layer` to both helpers so the skip key matches. */
+activation?: Pick<ExtensionActivationResult, "failed">;
+/** Per-hook teardown bound, forwarded as `deactivate_timeout_ms`. Use `0` (or `Infinity`) to wait indefinitely; omit to keep the host default. */
+deactivateTimeoutMs?: number;
 }
 /**
  * Options for {@link runRegisteredCommandForTest} — the inputs forwarded to a
  * registered extension command handler when exercising its behavior in a test.
  */
 export interface RunRegisteredCommandForTestOptions {
-    /** Full registered command path to invoke, e.g. `"hello"` or `"todos import"`. Matched against `commands.handlers[].command` after normalization (trimmed, lower-cased, internal whitespace collapsed), mirroring runtime dispatch. */
-    command: string;
-    /** Positional arguments forwarded as `context.args` (default: none). */
-    args?: readonly string[];
-    /** Parsed flags/options forwarded as `context.options` (default: none). */
-    options?: Record<string, unknown>;
-    /** Global option overrides merged onto the agent-safe test defaults (`{ json: true, quiet: true, noPager: true }`), forwarded as `context.global`. */
-    global?: Partial<GlobalOptions>;
-    /** Resolved tracker storage root forwarded as `context.pm_root` (default: `""`), normally `<workspace>/.agents/pm`; this is not the workspace root. */
-    pmRoot?: string;
-    /** Explicit host SDK override for specialized tests. Mutually exclusive with sdkFactory. */
-    sdk?: ExtensionCommandSdk;
-    /** Lazily build a typed host SDK override from the resolved test context. `pmRoot` is the tracker storage root (normally `<workspace>/.agents/pm`), not the workspace root. */
-    sdkFactory?: (context: {
-        /** Tracker storage root for tracker data under `.agents/pm`, not the workspace root. */
-        pmRoot: string;
-        global: GlobalOptions;
-    }) => ExtensionCommandSdk;
+/** Full registered command path to invoke, e.g. `"hello"` or `"todos import"`. Matched against `commands.handlers[].command` after normalization (trimmed, lower-cased, internal whitespace collapsed), mirroring runtime dispatch. */
+command: string;
+/** Positional arguments forwarded as `context.args` (default: none). */
+args?: readonly string[];
+/** Parsed flags/options forwarded as `context.options` (default: none). */
+options?: Record<string, unknown>;
+/** Global option overrides merged onto the agent-safe test defaults (`{ json: true, quiet: true, noPager: true }`), forwarded as `context.global`. */
+global?: Partial<GlobalOptions>;
+/** Resolved tracker storage root forwarded as `context.pm_root` (default: `""`), normally `<workspace>/.agents/pm`; this is not the workspace root. */
+pmRoot?: string;
+/** Explicit host SDK override for specialized tests. Mutually exclusive with sdkFactory. */
+sdk?: ExtensionCommandSdk;
+/** Lazily build a typed host SDK override from the resolved test context. `pmRoot` is the tracker storage root (normally `<workspace>/.agents/pm`), not the workspace root. */
+sdkFactory?: (context: {
+/** Tracker storage root for tracker data under `.agents/pm`, not the workspace root. */
+pmRoot: string;
+global: GlobalOptions;
+}) => ExtensionCommandSdk;
 }
 /** Options for invoking a registered transactional mutation guard in package tests. */
 export interface RunRegisteredMutationGuardForTestOptions {
-    /** Synthetic proposed mutation context, including a host-bound read-only SDK. */
-    context: BeforeMutationHookContext;
+/** Synthetic proposed mutation context, including a host-bound read-only SDK. */
+context: BeforeMutationHookContext;
 }
 /**
  * Options for {@link runRegisteredHookForTest} — the lifecycle `kind` to fire and
@@ -80,20 +84,20 @@ export interface RunRegisteredMutationGuardForTestOptions {
  * pass an index context to a read hook.
  */
 export type RunRegisteredHookForTestOptions = {
-    kind: "before_command";
-    context: BeforeCommandHookContext;
+kind: "before_command";
+context: BeforeCommandHookContext;
 } | {
-    kind: "after_command";
-    context: AfterCommandHookContext;
+kind: "after_command";
+context: AfterCommandHookContext;
 } | {
-    kind: "on_read";
-    context: OnReadHookContext;
+kind: "on_read";
+context: OnReadHookContext;
 } | {
-    kind: "on_write";
-    context: OnWriteHookContext;
+kind: "on_write";
+context: OnWriteHookContext;
 } | {
-    kind: "on_index";
-    context: OnIndexHookContext;
+kind: "on_index";
+context: OnIndexHookContext;
 };
 /**
  * Maps each invokable search-provider operation to the context type its function
@@ -103,16 +107,16 @@ export type RunRegisteredHookForTestOptions = {
  * `queryExpansion`, and `rerank`.
  */
 export interface SearchProviderOperationContexts {
-    /** Value that configures or reports query for this contract. */
-    query: SearchProviderQueryContext;
-    /** Value that configures or reports embed for this contract. */
-    embed: SearchProviderEmbedContext;
-    /** Value that configures or reports embed batch for this contract. */
-    embedBatch: SearchProviderEmbedBatchContext;
-    /** Value that configures or reports query expansion for this contract. */
-    queryExpansion: SearchProviderQueryExpansionContext;
-    /** Value that configures or reports rerank for this contract. */
-    rerank: SearchProviderRerankContext;
+/** Value that configures or reports query for this contract. */
+query: SearchProviderQueryContext;
+/** Value that configures or reports embed for this contract. */
+embed: SearchProviderEmbedContext;
+/** Value that configures or reports embed batch for this contract. */
+embedBatch: SearchProviderEmbedBatchContext;
+/** Value that configures or reports query expansion for this contract. */
+queryExpansion: SearchProviderQueryExpansionContext;
+/** Value that configures or reports rerank for this contract. */
+rerank: SearchProviderRerankContext;
 }
 /**
  * Maps each invokable search-provider operation to the result type its function
@@ -120,16 +124,16 @@ export interface SearchProviderOperationContexts {
  * type from the chosen `operation` instead of a union the caller must narrow.
  */
 export interface SearchProviderOperationResults {
-    /** Value that configures or reports query for this contract. */
-    query: SearchProviderQueryResult;
-    /** Value that configures or reports embed for this contract. */
-    embed: number[];
-    /** Value that configures or reports embed batch for this contract. */
-    embedBatch: number[][];
-    /** Value that configures or reports query expansion for this contract. */
-    queryExpansion: SearchProviderQueryExpansionResult;
-    /** Value that configures or reports rerank for this contract. */
-    rerank: SearchProviderRerankResult;
+/** Value that configures or reports query for this contract. */
+query: SearchProviderQueryResult;
+/** Value that configures or reports embed for this contract. */
+embed: number[];
+/** Value that configures or reports embed batch for this contract. */
+embedBatch: number[][];
+/** Value that configures or reports query expansion for this contract. */
+queryExpansion: SearchProviderQueryExpansionResult;
+/** Value that configures or reports rerank for this contract. */
+rerank: SearchProviderRerankResult;
 }
 /**
  * Options for {@link runRegisteredSearchProviderForTest}: the registered
@@ -140,14 +144,14 @@ export interface SearchProviderOperationResults {
  * {@link SearchProviderRerankContext}, and so on.
  */
 export type RunRegisteredSearchProviderForTestOptions = {
-    [Operation in keyof SearchProviderOperationContexts]: {
-        /** Registered provider name to resolve, matched case-insensitively as the host does. */
-        provider: string;
-        /** Provider operation to invoke. */
-        operation: Operation;
-        /** Synthetic context handed to the resolved operation function. */
-        context: SearchProviderOperationContexts[Operation];
-    };
+[Operation in keyof SearchProviderOperationContexts]: {
+/** Registered provider name to resolve, matched case-insensitively as the host does. */
+provider: string;
+/** Provider operation to invoke. */
+operation: Operation;
+/** Synthetic context handed to the resolved operation function. */
+context: SearchProviderOperationContexts[Operation];
+};
 }[keyof SearchProviderOperationContexts];
 /**
  * Maps each invokable vector-store-adapter operation to the context type its
@@ -156,12 +160,12 @@ export type RunRegisteredSearchProviderForTestOptions = {
  * registered adapter: nearest-neighbour `query`, `upsert`, and `delete`.
  */
 export interface VectorStoreAdapterOperationContexts {
-    /** Value that configures or reports query for this contract. */
-    query: VectorStoreQueryContext;
-    /** Value that configures or reports upsert for this contract. */
-    upsert: VectorStoreUpsertContext;
-    /** Value that configures or reports delete for this contract. */
-    delete: VectorStoreDeleteContext;
+/** Value that configures or reports query for this contract. */
+query: VectorStoreQueryContext;
+/** Value that configures or reports upsert for this contract. */
+upsert: VectorStoreUpsertContext;
+/** Value that configures or reports delete for this contract. */
+delete: VectorStoreDeleteContext;
 }
 /**
  * Maps each invokable vector-store-adapter operation to the result type its
@@ -170,12 +174,12 @@ export interface VectorStoreAdapterOperationContexts {
  * throwing, so their result is `unknown` and typically ignored.
  */
 export interface VectorStoreAdapterOperationResults {
-    /** Value that configures or reports query for this contract. */
-    query: VectorStoreQueryHit[];
-    /** Value that configures or reports upsert for this contract. */
-    upsert: unknown;
-    /** Value that configures or reports delete for this contract. */
-    delete: unknown;
+/** Value that configures or reports query for this contract. */
+query: VectorStoreQueryHit[];
+/** Value that configures or reports upsert for this contract. */
+upsert: unknown;
+/** Value that configures or reports delete for this contract. */
+delete: unknown;
 }
 /**
  * Options for {@link runRegisteredVectorStoreAdapterForTest}: the registered
@@ -186,26 +190,26 @@ export interface VectorStoreAdapterOperationResults {
  * {@link VectorStoreDeleteContext}, and so on.
  */
 export type RunRegisteredVectorStoreAdapterForTestOptions = {
-    [Operation in keyof VectorStoreAdapterOperationContexts]: {
-        /** Registered adapter name to resolve, matched case-insensitively as the host does. */
-        adapter: string;
-        /** Adapter operation to invoke. */
-        operation: Operation;
-        /** Synthetic context handed to the resolved operation function. */
-        context: VectorStoreAdapterOperationContexts[Operation];
-    };
+[Operation in keyof VectorStoreAdapterOperationContexts]: {
+/** Registered adapter name to resolve, matched case-insensitively as the host does. */
+adapter: string;
+/** Adapter operation to invoke. */
+operation: Operation;
+/** Synthetic context handed to the resolved operation function. */
+context: VectorStoreAdapterOperationContexts[Operation];
+};
 }[keyof VectorStoreAdapterOperationContexts];
 /**
  * Options for {@link runRegisteredMigrationForTest}: which registered migration
  * to invoke and the workspace root its run context reports.
  */
 export interface RunRegisteredMigrationForTestOptions {
-    /** Registered migration id to resolve, matched case-insensitively against `definition.id`. */
-    migration: string;
-    /** Optional extension name to disambiguate when several extensions register the same id. */
-    extensionName?: string;
-    /** Resolved pm workspace root forwarded as `context.pm_root` (default `""`). */
-    pmRoot?: string;
+/** Registered migration id to resolve, matched case-insensitively against `definition.id`. */
+migration: string;
+/** Optional extension name to disambiguate when several extensions register the same id. */
+extensionName?: string;
+/** Resolved pm workspace root forwarded as `context.pm_root` (default `""`). */
+pmRoot?: string;
 }
 /**
  * Options for {@link runRegisteredImporterForTest} — the registered importer name
@@ -217,18 +221,18 @@ export interface RunRegisteredMigrationForTestOptions {
  * path internally, so authors never hand-build it.
  */
 export interface RunRegisteredImporterForTestOptions {
-    /** Registered importer name to resolve, e.g. `"csv"` for a `"csv import"` handler. */
-    importer: string;
-    /** Optional extension name to disambiguate when several extensions register the same importer. */
-    extensionName?: string;
-    /** Positional arguments forwarded as `context.args` (default: none). */
-    args?: readonly string[];
-    /** Parsed flags/options forwarded as `context.options` (default: none). */
-    options?: Record<string, unknown>;
-    /** Global option overrides merged onto the agent-safe test defaults (`{ json: true, quiet: true, noPager: true }`), forwarded as `context.global`. */
-    global?: Partial<GlobalOptions>;
-    /** Resolved pm workspace root forwarded as `context.pm_root` (default: `""`). */
-    pmRoot?: string;
+/** Registered importer name to resolve, e.g. `"csv"` for a `"csv import"` handler. */
+importer: string;
+/** Optional extension name to disambiguate when several extensions register the same importer. */
+extensionName?: string;
+/** Positional arguments forwarded as `context.args` (default: none). */
+args?: readonly string[];
+/** Parsed flags/options forwarded as `context.options` (default: none). */
+options?: Record<string, unknown>;
+/** Global option overrides merged onto the agent-safe test defaults (`{ json: true, quiet: true, noPager: true }`), forwarded as `context.global`. */
+global?: Partial<GlobalOptions>;
+/** Resolved pm workspace root forwarded as `context.pm_root` (default: `""`). */
+pmRoot?: string;
 }
 /**
  * Options for {@link runRegisteredExporterForTest} — the registered exporter name
@@ -240,55 +244,55 @@ export interface RunRegisteredImporterForTestOptions {
  * path internally, so authors never hand-build it.
  */
 export interface RunRegisteredExporterForTestOptions {
-    /** Registered exporter name to resolve, e.g. `"csv"` for a `"csv export"` handler. */
-    exporter: string;
-    /** Optional extension name to disambiguate when several extensions register the same exporter. */
-    extensionName?: string;
-    /** Positional arguments forwarded as `context.args` (default: none). */
-    args?: readonly string[];
-    /** Parsed flags/options forwarded as `context.options` (default: none). */
-    options?: Record<string, unknown>;
-    /** Global option overrides merged onto the agent-safe test defaults (`{ json: true, quiet: true, noPager: true }`), forwarded as `context.global`. */
-    global?: Partial<GlobalOptions>;
-    /** Resolved pm workspace root forwarded as `context.pm_root` (default: `""`). */
-    pmRoot?: string;
+/** Registered exporter name to resolve, e.g. `"csv"` for a `"csv export"` handler. */
+exporter: string;
+/** Optional extension name to disambiguate when several extensions register the same exporter. */
+extensionName?: string;
+/** Positional arguments forwarded as `context.args` (default: none). */
+args?: readonly string[];
+/** Parsed flags/options forwarded as `context.options` (default: none). */
+options?: Record<string, unknown>;
+/** Global option overrides merged onto the agent-safe test defaults (`{ json: true, quiet: true, noPager: true }`), forwarded as `context.global`. */
+global?: Partial<GlobalOptions>;
+/** Resolved pm workspace root forwarded as `context.pm_root` (default: `""`). */
+pmRoot?: string;
 }
 /** Documents the extension deactivation expectation payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionDeactivationExpectation {
-    /** Expected count of extensions whose `deactivate` ran without throwing (default `1`). */
-    deactivated?: number;
-    /** Expected count of teardown failures (default `0`). */
-    failed?: number;
+/** Expected count of extensions whose `deactivate` ran without throwing (default `1`). */
+deactivated?: number;
+/** Expected count of teardown failures (default `0`). */
+failed?: number;
 }
 type NamedRegistrationExpectation<TLegacyKey extends string, TValue, TDetails extends object = Record<never, never>> = TDetails & (({
-    name: TValue;
+name: TValue;
 } & Partial<Record<TLegacyKey, TValue>>) | ({
-    name?: TValue;
+name?: TValue;
 } & Record<TLegacyKey, TValue>));
 /** Documents the registered command contract expectation payload exchanged by command, SDK, and package integrations. `name` is canonical; `command` remains a backward-compatible alias. */
 export type RegisteredCommandContractExpectation = NamedRegistrationExpectation<"command", string, {
-    /** Value that configures or reports action for this contract. */
-    action?: string;
-    /** Value that configures or reports extension name for this contract. */
-    extensionName?: string;
-    /** Value that configures or reports arguments for this contract. */
-    arguments?: string[];
-    /** Value that configures or reports flags for this contract. */
-    flags?: string[];
+/** Value that configures or reports action for this contract. */
+action?: string;
+/** Value that configures or reports extension name for this contract. */
+extensionName?: string;
+/** Value that configures or reports arguments for this contract. */
+arguments?: string[];
+/** Value that configures or reports flags for this contract. */
+flags?: string[];
 }>;
 /** Documents the registered command contract assertion payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredCommandContractAssertion {
-    /** Value that configures or reports command for this contract. */
-    command: RegisteredExtensionCommandDefinition;
-    /** Value that configures or reports flags for this contract. */
-    flags: FlagDefinition[];
+/** Value that configures or reports command for this contract. */
+command: RegisteredExtensionCommandDefinition;
+/** Value that configures or reports flags for this contract. */
+flags: FlagDefinition[];
 }
 /** Documents the registered flags expectation payload exchanged by command, SDK, and package integrations. */
 export type RegisteredFlagsExpectation = NamedRegistrationExpectation<"targetCommand", string, {
-    /** Value that configures or reports extension name for this contract. */
-    extensionName?: string;
-    /** Value that configures or reports flags for this contract. */
-    flags?: string[];
+/** Value that configures or reports extension name for this contract. */
+extensionName?: string;
+/** Value that configures or reports flags for this contract. */
+flags?: string[];
 }>;
 /** Public hook lifecycle kinds an extension can register through `api.hooks.*`. */
 export type RegisteredHookKind = "before_command" | "before_mutation" | "after_command" | "on_read" | "on_write" | "on_index";
@@ -296,141 +300,141 @@ declare const HOOK_KIND_TO_REGISTRY_FIELD: Record<RegisteredHookKind, keyof Exte
 type RegisteredHookEntry<TKind extends RegisteredHookKind> = NonNullable<ExtensionHookRegistry[(typeof HOOK_KIND_TO_REGISTRY_FIELD)[TKind]]>[number];
 /** Documents the registered hook expectation payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredHookExpectation {
-    /** Value that configures or reports kind for this contract. */
-    kind: RegisteredHookKind;
-    /** Value that configures or reports extension name for this contract. */
-    extensionName?: string;
+/** Value that configures or reports kind for this contract. */
+kind: RegisteredHookKind;
+/** Value that configures or reports extension name for this contract. */
+extensionName?: string;
 }
 /** Documents the registered search provider expectation payload exchanged by command, SDK, and package integrations. */
 export type RegisteredSearchProviderExpectation = NamedRegistrationExpectation<"provider", string, {
-    /** Value that configures or reports extension name for this contract. */
-    extensionName?: string;
+/** Value that configures or reports extension name for this contract. */
+extensionName?: string;
 }>;
 /** Documents the registered vector store adapter expectation payload exchanged by command, SDK, and package integrations. */
 export type RegisteredVectorStoreAdapterExpectation = NamedRegistrationExpectation<"adapter", string, {
-    /** Value that configures or reports extension name for this contract. */
-    extensionName?: string;
+/** Value that configures or reports extension name for this contract. */
+extensionName?: string;
 }>;
 /** Documents the registered importer expectation payload exchanged by command, SDK, and package integrations. */
 export type RegisteredImporterExpectation = NamedRegistrationExpectation<"importer", string, {
-    /** Value that configures or reports extension name for this contract. */
-    extensionName?: string;
+/** Value that configures or reports extension name for this contract. */
+extensionName?: string;
 }>;
 /** Documents the registered exporter expectation payload exchanged by command, SDK, and package integrations. */
 export type RegisteredExporterExpectation = NamedRegistrationExpectation<"exporter", string, {
-    /** Value that configures or reports extension name for this contract. */
-    extensionName?: string;
+/** Value that configures or reports extension name for this contract. */
+extensionName?: string;
 }>;
 /** Documents the registered item field expectation payload exchanged by command, SDK, and package integrations. */
 export type RegisteredItemFieldExpectation = NamedRegistrationExpectation<"field", string, {
-    /** Value that configures or reports extension name for this contract. */
-    extensionName?: string;
-    /** Schema type that determines the shape and validation rules for this value. */
-    type?: SchemaFieldDefinition["type"];
+/** Value that configures or reports extension name for this contract. */
+extensionName?: string;
+/** Schema type that determines the shape and validation rules for this value. */
+type?: SchemaFieldDefinition["type"];
 }>;
 /** Documents the registered item field assertion payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredItemFieldAssertion {
-    /** Value that configures or reports registration for this contract. */
-    registration: RegisteredExtensionSchemaFieldDefinitions;
-    /** Value that configures or reports field for this contract. */
-    field: SchemaFieldDefinition;
+/** Value that configures or reports registration for this contract. */
+registration: RegisteredExtensionSchemaFieldDefinitions;
+/** Value that configures or reports field for this contract. */
+field: SchemaFieldDefinition;
 }
 /** Documents the registered item type expectation payload exchanged by command, SDK, and package integrations. */
 export type RegisteredItemTypeExpectation = NamedRegistrationExpectation<"itemType", string, {
-    /** Value that configures or reports extension name for this contract. */
-    extensionName?: string;
-    /** Value that configures or reports folder for this contract. */
-    folder?: string;
+/** Value that configures or reports extension name for this contract. */
+extensionName?: string;
+/** Value that configures or reports folder for this contract. */
+folder?: string;
 }>;
 /** Documents the registered item type assertion payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredItemTypeAssertion {
-    /** Value that configures or reports registration for this contract. */
-    registration: RegisteredExtensionSchemaItemTypeDefinitions;
-    /** Schema type that determines the shape and validation rules for this value. */
-    itemType: SchemaItemTypeDefinition;
+/** Value that configures or reports registration for this contract. */
+registration: RegisteredExtensionSchemaItemTypeDefinitions;
+/** Schema type that determines the shape and validation rules for this value. */
+itemType: SchemaItemTypeDefinition;
 }
 /** Documents the registered command override expectation payload exchanged by command, SDK, and package integrations. */
 export type RegisteredCommandOverrideExpectation = NamedRegistrationExpectation<"command", string, {
-    /** Value that configures or reports extension name for this contract. */
-    extensionName?: string;
+/** Value that configures or reports extension name for this contract. */
+extensionName?: string;
 }>;
 /** Documents the registered parser override expectation payload exchanged by command, SDK, and package integrations. */
 export type RegisteredParserOverrideExpectation = NamedRegistrationExpectation<"command", string, {
-    /** Value that configures or reports extension name for this contract. */
-    extensionName?: string;
+/** Value that configures or reports extension name for this contract. */
+extensionName?: string;
 }>;
 /** Documents the registered preflight override expectation payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredPreflightOverrideExpectation {
-    /** Value that configures or reports extension name for this contract. */
-    extensionName?: string;
+/** Value that configures or reports extension name for this contract. */
+extensionName?: string;
 }
 /** Documents the registered renderer override expectation payload exchanged by command, SDK, and package integrations. */
 export type RegisteredRendererOverrideExpectation = NamedRegistrationExpectation<"format", OutputRendererFormat, {
-    /** Value that configures or reports extension name for this contract. */
-    extensionName?: string;
+/** Value that configures or reports extension name for this contract. */
+extensionName?: string;
 }>;
 /** Documents the registered service override expectation payload exchanged by command, SDK, and package integrations. */
 export type RegisteredServiceOverrideExpectation = NamedRegistrationExpectation<"service", ExtensionServiceName, {
-    /** Value that configures or reports extension name for this contract. */
-    extensionName?: string;
+/** Value that configures or reports extension name for this contract. */
+extensionName?: string;
 }>;
 /** Documents the registered migration expectation payload exchanged by command, SDK, and package integrations. */
 export type RegisteredMigrationExpectation = NamedRegistrationExpectation<"migration", string, {
-    /** Value that configures or reports extension name for this contract. */
-    extensionName?: string;
-    /** Value that configures or reports mandatory for this contract. */
-    mandatory?: boolean;
+/** Value that configures or reports extension name for this contract. */
+extensionName?: string;
+/** Value that configures or reports mandatory for this contract. */
+mandatory?: boolean;
 }>;
 /** Documents the registered project-profile expectation payload exchanged by command, SDK, and package integrations. */
 export type RegisteredProfileExpectation = NamedRegistrationExpectation<"profile", string, {
-    /** Restrict the match to a single extension when several are active. */
-    extensionName?: string;
+/** Restrict the match to a single extension when several are active. */
+extensionName?: string;
 }>;
 /** Documents the registered project-profile assertion payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredProfileAssertion {
-    /** The matching registration entry. */
-    registration: RegisteredExtensionProjectProfile;
-    /** The registered profile definition. */
-    profile: ProjectProfileDefinition;
+/** The matching registration entry. */
+registration: RegisteredExtensionProjectProfile;
+/** The registered profile definition. */
+profile: ProjectProfileDefinition;
 }
 /** Documents the extension capability usage expectation payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionCapabilityUsageExpectation {
-    /** Capabilities the manifest declares. Mirror `manifest.capabilities` here so the assertion fails when the manifest grants more than the code uses. */
-    declared: readonly ExtensionCapability[];
-    /** Restrict reconciliation to a single extension when the activation has several. */
-    extensionName?: string;
-    /** Capabilities allowed to be declared without being exercised (e.g. ones a runtime registers only behind a config flag). These are excluded from the least-privilege failure. */
-    allowUnused?: readonly ExtensionCapability[];
+/** Capabilities the manifest declares. Mirror `manifest.capabilities` here so the assertion fails when the manifest grants more than the code uses. */
+declared: readonly ExtensionCapability[];
+/** Restrict reconciliation to a single extension when the activation has several. */
+extensionName?: string;
+/** Capabilities allowed to be declared without being exercised (e.g. ones a runtime registers only behind a config flag). These are excluded from the least-privilege failure. */
+allowUnused?: readonly ExtensionCapability[];
 }
 /** Documents the extension capability usage assertion payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionCapabilityUsageAssertion {
-    /** Declared capabilities considered, sorted and de-duplicated. */
-    declared: ExtensionCapability[];
-    /** Capabilities the extension actually registered against, sorted. */
-    used: ExtensionCapability[];
-    /** Declared capabilities with no matching registration after the allowlist. */
-    unused: ExtensionCapability[];
+/** Declared capabilities considered, sorted and de-duplicated. */
+declared: ExtensionCapability[];
+/** Capabilities the extension actually registered against, sorted. */
+used: ExtensionCapability[];
+/** Declared capabilities with no matching registration after the allowlist. */
+unused: ExtensionCapability[];
 }
 /** Restricts package manifest resource expectation values accepted by command, SDK, and storage contracts. */
 export type PackageManifestResourceExpectation = Partial<Record<PmPackageResourceKind, readonly string[]>>;
 /** Documents the package manifest expectation payload exchanged by command, SDK, and package integrations. */
 export interface PackageManifestExpectation {
-    /** Value that configures or reports package name for this contract. */
-    packageName?: string;
-    /** Value that configures or reports aliases for this contract. */
-    aliases?: readonly string[];
-    /** Value that configures or reports resources for this contract. */
-    resources?: PackageManifestResourceExpectation;
+/** Value that configures or reports package name for this contract. */
+packageName?: string;
+/** Value that configures or reports aliases for this contract. */
+aliases?: readonly string[];
+/** Value that configures or reports resources for this contract. */
+resources?: PackageManifestResourceExpectation;
 }
 /**
  * Options for {@link ExtensionTestHarness.renderMarkdown}.
  */
 export interface RenderExtensionHarnessMarkdownOptions extends ExtensionSurfaceMarkdownOptions {
-    /**
+/**
      * Restrict the rendered summary to one activated extension by name. Defaults
      * to the full activation union, matching {@link ExtensionTestHarness.activationSummary}.
      */
-    extensionName?: string;
+extensionName?: string;
 }
 /**
  * Activate one in-memory extension module for package tests.
@@ -586,9 +590,9 @@ export declare function runRegisteredServiceOverrideForTest(services: ExtensionS
  * wiring bug in the test rather than a behavior under test.
  */
 export declare function runRegisteredSearchProviderForTest<Operation extends keyof SearchProviderOperationContexts>(registrations: ExtensionRegistrationRegistry, options: {
-    provider: string;
-    operation: Operation;
-    context: SearchProviderOperationContexts[Operation];
+provider: string;
+operation: Operation;
+context: SearchProviderOperationContexts[Operation];
 }): Promise<SearchProviderOperationResults[Operation]>;
 /**
  * Invoke an operation of a registered vector store adapter through the same name
@@ -609,9 +613,9 @@ export declare function runRegisteredSearchProviderForTest<Operation extends key
  * the requested operation.
  */
 export declare function runRegisteredVectorStoreAdapterForTest<Operation extends keyof VectorStoreAdapterOperationContexts>(registrations: ExtensionRegistrationRegistry, options: {
-    adapter: string;
-    operation: Operation;
-    context: VectorStoreAdapterOperationContexts[Operation];
+adapter: string;
+operation: Operation;
+context: VectorStoreAdapterOperationContexts[Operation];
 }): Promise<VectorStoreAdapterOperationResults[Operation]>;
 /**
  * Invoke a registered schema migration's `run` function through the same runtime
@@ -703,7 +707,7 @@ export declare function assertRegisteredFlags(registrations: ExtensionRegistrati
  * registration registry, so this helper accepts an `ExtensionHookRegistry`.
  */
 export declare function assertRegisteredHook<TKind extends RegisteredHookKind>(hooks: ExtensionHookRegistry, expectation: RegisteredHookExpectation & {
-    kind: TKind;
+kind: TKind;
 }): RegisteredHookEntry<TKind>;
 /** Assert that an activated extension registration registry contains a search provider with the expected name (optionally scoped to a specific extension). */
 export declare function assertRegisteredSearchProvider(registrations: ExtensionRegistrationRegistry, expectation: RegisteredSearchProviderExpectation): RegisteredExtensionSearchProvider;
@@ -815,8 +819,8 @@ export declare function assertExtensionCapabilityUsage(activation: ExtensionActi
 export declare function assertExtensionBlueprint(blueprint: ExtensionBlueprint, options?: LintExtensionBlueprintOptions): ExtensionBlueprintLintResult;
 /** Options for {@link assertProjectProfile}. */
 export interface AssertProjectProfileOptions {
-    /** Also throw when the profile produces `warning`-severity findings (e.g. a workflow transition referencing a status no profile or built-in defines). Off by default so warnings stay advisory; turn on for strict CI gates. */
-    strict?: boolean;
+/** Also throw when the profile produces `warning`-severity findings (e.g. a workflow transition referencing a status no profile or built-in defines). Off by default so warnings stay advisory; turn on for strict CI gates. */
+strict?: boolean;
 }
 /**
  * Assert a {@link ProjectProfileDefinition} is internally consistent in a test,
@@ -837,16 +841,16 @@ export declare function assertProjectProfile(profile: ProjectProfileDefinition,
  * assertion throws otherwise).
  */
 export interface ExtensionManifestBlueprintMatch {
-    /** The least-privilege capability set the blueprint exercises (from `deriveExtensionCapabilities`). */
-    used: ExtensionCapability[];
-    /** The manifest's declared capabilities, legacy-alias resolved and normalized. */
-    declared: ExtensionCapability[];
-    /** Capabilities the blueprint uses but the manifest omits — would crash activation. Empty on success. */
-    missing: ExtensionCapability[];
-    /** Capabilities the manifest declares but no surface exercises — violates least privilege. Empty on success. */
-    unused: ExtensionCapability[];
-    /** Every lint finding for the blueprint, so callers can inspect advisory warnings. */
-    findings: ExtensionBlueprintLintFinding[];
+/** The least-privilege capability set the blueprint exercises (from `deriveExtensionCapabilities`). */
+used: ExtensionCapability[];
+/** The manifest's declared capabilities, legacy-alias resolved and normalized. */
+declared: ExtensionCapability[];
+/** Capabilities the blueprint uses but the manifest omits — would crash activation. Empty on success. */
+missing: ExtensionCapability[];
+/** Capabilities the manifest declares but no surface exercises — violates least privilege. Empty on success. */
+unused: ExtensionCapability[];
+/** Every lint finding for the blueprint, so callers can inspect advisory warnings. */
+findings: ExtensionBlueprintLintFinding[];
 }
 /**
  * Strictly assert a manifest's `capabilities` equal the least-privilege set a
@@ -922,100 +926,100 @@ export declare function assertExtensionPreflight(blueprint: ExtensionBlueprint,
  * the standalone helpers for any surface not covered by a convenience method.
  */
 export interface ExtensionTestHarness {
-    /** The in-memory extension module supplied to {@link createExtensionTestHarness}. */
-    readonly module: unknown;
-    /** Resolved extension name (manifest name, explicit override, or `"test-extension"`). */
-    readonly name: string;
-    /** Layer recorded for the in-memory extension (defaults to `"project"`). */
-    readonly layer: ExtensionLayer;
-    /** The underlying activation result; use it to reach standalone helpers directly. */
-    readonly activation: ExtensionActivationResult;
-    /** Bound {@link describeExtensionActivation} over the whole `activation`. */
-    activationSummary(options?: DescribeExtensionActivationOptions): ExtensionActivationSummary;
-    /**
+/** The in-memory extension module supplied to {@link createExtensionTestHarness}. */
+readonly module: unknown;
+/** Resolved extension name (manifest name, explicit override, or `"test-extension"`). */
+readonly name: string;
+/** Layer recorded for the in-memory extension (defaults to `"project"`). */
+readonly layer: ExtensionLayer;
+/** The underlying activation result; use it to reach standalone helpers directly. */
+readonly activation: ExtensionActivationResult;
+/** Bound {@link describeExtensionActivation} over the whole `activation`. */
+activationSummary(options?: DescribeExtensionActivationOptions): ExtensionActivationSummary;
+/**
      * Bound {@link renderExtensionSurfaceMarkdown} over {@link activationSummary},
      * so tests and README generators can produce deterministic surface docs from
      * the same harness they use for assert/run coverage.
      */
-    renderMarkdown(options?: RenderExtensionHarnessMarkdownOptions): string;
-    /** Bound {@link assertRegisteredCommandContract} over `activation.registrations`. */
-    assertCommandContract(expectation: RegisteredCommandContractExpectation): RegisteredCommandContractAssertion;
-    /** Bound {@link assertRegisteredFlags} over `activation.registrations`. */
-    assertFlags(expectation: RegisteredFlagsExpectation): RegisteredExtensionFlagDefinitions;
-    /** Bound {@link assertRegisteredItemField} over `activation.registrations`. */
-    assertItemField(expectation: RegisteredItemFieldExpectation): RegisteredItemFieldAssertion;
-    /** Bound {@link assertRegisteredItemType} over `activation.registrations`. */
-    assertItemType(expectation: RegisteredItemTypeExpectation): RegisteredItemTypeAssertion;
-    /** Bound {@link assertRegisteredProfile} over `activation.registrations`. */
-    assertProfile(expectation: RegisteredProfileExpectation): RegisteredProfileAssertion;
-    /** Bound {@link assertRegisteredHook} over `activation.hooks`. */
-    assertHook<TKind extends RegisteredHookKind>(expectation: RegisteredHookExpectation & {
-        kind: TKind;
-    }): RegisteredHookEntry<TKind>;
-    /** Bound {@link assertRegisteredCommandOverride} over `activation.commands`. */
-    assertCommandOverride(expectation: RegisteredCommandOverrideExpectation): RegisteredExtensionCommandOverride;
-    /** Bound {@link assertRegisteredParserOverride} over `activation.parsers`. */
-    assertParserOverride(expectation: RegisteredParserOverrideExpectation): RegisteredExtensionParserOverride;
-    /** Bound {@link assertRegisteredPreflightOverride} over `activation.preflight`. */
-    assertPreflightOverride(expectation?: RegisteredPreflightOverrideExpectation): RegisteredExtensionPreflightOverride;
-    /** Bound {@link assertRegisteredRendererOverride} over `activation.renderers`. */
-    assertRendererOverride(expectation: RegisteredRendererOverrideExpectation): RegisteredExtensionRendererOverride;
-    /** Bound {@link assertRegisteredServiceOverride} over `activation.services`. */
-    assertServiceOverride(expectation: RegisteredServiceOverrideExpectation): RegisteredExtensionServiceOverride;
-    /** Bound {@link assertRegisteredSearchProvider} over `activation.registrations`. */
-    assertSearchProvider(expectation: RegisteredSearchProviderExpectation): RegisteredExtensionSearchProvider;
-    /** Bound {@link assertRegisteredVectorStoreAdapter} over `activation.registrations`. */
-    assertVectorStoreAdapter(expectation: RegisteredVectorStoreAdapterExpectation): RegisteredExtensionVectorStoreAdapter;
-    /** Bound {@link assertRegisteredImporter} over `activation.registrations`. */
-    assertImporter(expectation: RegisteredImporterExpectation): RegisteredExtensionImporter;
-    /** Bound {@link assertRegisteredExporter} over `activation.registrations`. */
-    assertExporter(expectation: RegisteredExporterExpectation): RegisteredExtensionExporter;
-    /** Bound {@link assertRegisteredMigration} over `activation.registrations`. */
-    assertMigration(expectation: RegisteredMigrationExpectation): RegisteredExtensionSchemaMigrationDefinition;
-    /** Bound {@link assertExtensionCapabilityUsage} over the whole `activation`. */
-    assertCapabilityUsage(expectation: ExtensionCapabilityUsageExpectation): ExtensionCapabilityUsageAssertion;
-    /** Bound {@link runRegisteredCommandForTest} over `activation.commands`. */
-    runCommand(options: RunRegisteredCommandForTestOptions): Promise<CommandHandlerResult>;
-    /** Bound {@link runRegisteredHookForTest} over `activation.hooks`. */
-    runHook(options: RunRegisteredHookForTestOptions): Promise<string[]>;
-    /** Bound transactional mutation-guard runner over `activation.hooks`. */
-    runMutationGuard(options: RunRegisteredMutationGuardForTestOptions): Promise<void>;
-    /** Bound {@link runRegisteredCommandOverrideForTest} over `activation.commands`. */
-    runCommandOverride(context: CommandOverrideContext): Promise<CommandOverrideResult>;
-    /** Bound {@link runRegisteredParserOverrideForTest} over `activation.parsers`. */
-    runParserOverride(context: ParserOverrideContext): Promise<ParserOverrideResult>;
-    /** Bound {@link runRegisteredPreflightOverrideForTest} over `activation.preflight`. */
-    runPreflightOverride(context: PreflightOverrideContext): Promise<PreflightOverrideResult>;
-    /** Bound {@link runRegisteredRendererOverrideForTest} over `activation.renderers`. */
-    runRendererOverride(context: RendererOverrideContext): Promise<RendererOverrideResult>;
-    /** Bound {@link runRegisteredServiceOverrideForTest} over `activation.services`. */
-    runServiceOverride(context: ServiceOverrideContext): Promise<ServiceOverrideResult>;
-    /** Bound {@link runRegisteredSearchProviderForTest} over `activation.registrations`. */
-    runSearchProvider<Operation extends keyof SearchProviderOperationContexts>(options: {
-        provider: string;
-        operation: Operation;
-        context: SearchProviderOperationContexts[Operation];
-    }): Promise<SearchProviderOperationResults[Operation]>;
-    /** Bound {@link runRegisteredVectorStoreAdapterForTest} over `activation.registrations`. */
-    runVectorStoreAdapter<Operation extends keyof VectorStoreAdapterOperationContexts>(options: {
-        adapter: string;
-        operation: Operation;
-        context: VectorStoreAdapterOperationContexts[Operation];
-    }): Promise<VectorStoreAdapterOperationResults[Operation]>;
-    /** Bound {@link runRegisteredMigrationForTest} over `activation.registrations`. */
-    runMigration(options: RunRegisteredMigrationForTestOptions): Promise<unknown>;
-    /** Bound {@link runRegisteredImporterForTest} over the whole `activation`. */
-    runImporter(options: RunRegisteredImporterForTestOptions): Promise<CommandHandlerResult>;
-    /** Bound {@link runRegisteredExporterForTest} over the whole `activation`. */
-    runExporter(options: RunRegisteredExporterForTestOptions): Promise<CommandHandlerResult>;
-    /**
+renderMarkdown(options?: RenderExtensionHarnessMarkdownOptions): string;
+/** Bound {@link assertRegisteredCommandContract} over `activation.registrations`. */
+assertCommandContract(expectation: RegisteredCommandContractExpectation): RegisteredCommandContractAssertion;
+/** Bound {@link assertRegisteredFlags} over `activation.registrations`. */
+assertFlags(expectation: RegisteredFlagsExpectation): RegisteredExtensionFlagDefinitions;
+/** Bound {@link assertRegisteredItemField} over `activation.registrations`. */
+assertItemField(expectation: RegisteredItemFieldExpectation): RegisteredItemFieldAssertion;
+/** Bound {@link assertRegisteredItemType} over `activation.registrations`. */
+assertItemType(expectation: RegisteredItemTypeExpectation): RegisteredItemTypeAssertion;
+/** Bound {@link assertRegisteredProfile} over `activation.registrations`. */
+assertProfile(expectation: RegisteredProfileExpectation): RegisteredProfileAssertion;
+/** Bound {@link assertRegisteredHook} over `activation.hooks`. */
+assertHook<TKind extends RegisteredHookKind>(expectation: RegisteredHookExpectation & {
+kind: TKind;
+}): RegisteredHookEntry<TKind>;
+/** Bound {@link assertRegisteredCommandOverride} over `activation.commands`. */
+assertCommandOverride(expectation: RegisteredCommandOverrideExpectation): RegisteredExtensionCommandOverride;
+/** Bound {@link assertRegisteredParserOverride} over `activation.parsers`. */
+assertParserOverride(expectation: RegisteredParserOverrideExpectation): RegisteredExtensionParserOverride;
+/** Bound {@link assertRegisteredPreflightOverride} over `activation.preflight`. */
+assertPreflightOverride(expectation?: RegisteredPreflightOverrideExpectation): RegisteredExtensionPreflightOverride;
+/** Bound {@link assertRegisteredRendererOverride} over `activation.renderers`. */
+assertRendererOverride(expectation: RegisteredRendererOverrideExpectation): RegisteredExtensionRendererOverride;
+/** Bound {@link assertRegisteredServiceOverride} over `activation.services`. */
+assertServiceOverride(expectation: RegisteredServiceOverrideExpectation): RegisteredExtensionServiceOverride;
+/** Bound {@link assertRegisteredSearchProvider} over `activation.registrations`. */
+assertSearchProvider(expectation: RegisteredSearchProviderExpectation): RegisteredExtensionSearchProvider;
+/** Bound {@link assertRegisteredVectorStoreAdapter} over `activation.registrations`. */
+assertVectorStoreAdapter(expectation: RegisteredVectorStoreAdapterExpectation): RegisteredExtensionVectorStoreAdapter;
+/** Bound {@link assertRegisteredImporter} over `activation.registrations`. */
+assertImporter(expectation: RegisteredImporterExpectation): RegisteredExtensionImporter;
+/** Bound {@link assertRegisteredExporter} over `activation.registrations`. */
+assertExporter(expectation: RegisteredExporterExpectation): RegisteredExtensionExporter;
+/** Bound {@link assertRegisteredMigration} over `activation.registrations`. */
+assertMigration(expectation: RegisteredMigrationExpectation): RegisteredExtensionSchemaMigrationDefinition;
+/** Bound {@link assertExtensionCapabilityUsage} over the whole `activation`. */
+assertCapabilityUsage(expectation: ExtensionCapabilityUsageExpectation): ExtensionCapabilityUsageAssertion;
+/** Bound {@link runRegisteredCommandForTest} over `activation.commands`. */
+runCommand(options: RunRegisteredCommandForTestOptions): Promise<CommandHandlerResult>;
+/** Bound {@link runRegisteredHookForTest} over `activation.hooks`. */
+runHook(options: RunRegisteredHookForTestOptions): Promise<string[]>;
+/** Bound transactional mutation-guard runner over `activation.hooks`. */
+runMutationGuard(options: RunRegisteredMutationGuardForTestOptions): Promise<void>;
+/** Bound {@link runRegisteredCommandOverrideForTest} over `activation.commands`. */
+runCommandOverride(context: CommandOverrideContext): Promise<CommandOverrideResult>;
+/** Bound {@link runRegisteredParserOverrideForTest} over `activation.parsers`. */
+runParserOverride(context: ParserOverrideContext): Promise<ParserOverrideResult>;
+/** Bound {@link runRegisteredPreflightOverrideForTest} over `activation.preflight`. */
+runPreflightOverride(context: PreflightOverrideContext): Promise<PreflightOverrideResult>;
+/** Bound {@link runRegisteredRendererOverrideForTest} over `activation.renderers`. */
+runRendererOverride(context: RendererOverrideContext): Promise<RendererOverrideResult>;
+/** Bound {@link runRegisteredServiceOverrideForTest} over `activation.services`. */
+runServiceOverride(context: ServiceOverrideContext): Promise<ServiceOverrideResult>;
+/** Bound {@link runRegisteredSearchProviderForTest} over `activation.registrations`. */
+runSearchProvider<Operation extends keyof SearchProviderOperationContexts>(options: {
+provider: string;
+operation: Operation;
+context: SearchProviderOperationContexts[Operation];
+}): Promise<SearchProviderOperationResults[Operation]>;
+/** Bound {@link runRegisteredVectorStoreAdapterForTest} over `activation.registrations`. */
+runVectorStoreAdapter<Operation extends keyof VectorStoreAdapterOperationContexts>(options: {
+adapter: string;
+operation: Operation;
+context: VectorStoreAdapterOperationContexts[Operation];
+}): Promise<VectorStoreAdapterOperationResults[Operation]>;
+/** Bound {@link runRegisteredMigrationForTest} over `activation.registrations`. */
+runMigration(options: RunRegisteredMigrationForTestOptions): Promise<unknown>;
+/** Bound {@link runRegisteredImporterForTest} over the whole `activation`. */
+runImporter(options: RunRegisteredImporterForTestOptions): Promise<CommandHandlerResult>;
+/** Bound {@link runRegisteredExporterForTest} over the whole `activation`. */
+runExporter(options: RunRegisteredExporterForTestOptions): Promise<CommandHandlerResult>;
+/**
      * Bound {@link deactivateExtensionForTest} — runs the real teardown engine for
      * this harness's module, forwarding its resolved `name`/`layer`/`activation` so
      * the skip-key matches and a never-initialized extension is not deactivated.
      */
-    deactivate(options?: {
-        deactivateTimeoutMs?: number;
-    }): Promise<ExtensionDeactivationResult>;
+deactivate(options?: {
+deactivateTimeoutMs?: number;
+}): Promise<ExtensionDeactivationResult>;
 }
 /**
  * Activate one in-memory extension module and return a fluent