@unbrained/pm-cli 2026.10.14 → 2026.10.17

package/dist/sdk/cli-contracts/runtime-contracts.d.ts

@@ -1,210 +1,210 @@
-import { type GlobalOptions, type ExtensionRegistrationRegistry, type RegisteredExtensionCommandDefinition, type RegisteredExtensionFlagDefinitions, type RuntimeFieldRegistry, readSettings } from "../runtime-primitives.js";
+import { type GlobalOptions,type ExtensionRegistrationRegistry,type RegisteredExtensionCommandDefinition,type RegisteredExtensionFlagDefinitions,type RuntimeFieldRegistry,readSettings } from "../runtime-primitives.js";
 import { PM_HISTORY_OPERATION_CONTRACT } from "../../core/history/operation-contract.js";
 import { type McpToolContract } from "../../mcp/tool-definitions.js";
-import { PM_TOOL_ACTIONS, type CliFlagContract, type CommanderOptionAliasContract, type PmCommandOutputBudgetContract, type PmDiagnosticOutputBudgetContract, type PmCommandAliasContract } from "../cli-contracts.js";
-import { type ListCommandName, type ListProjectionMode } from "../query/list.js";
+import { PM_TOOL_ACTIONS,type CliFlagContract,type CommanderOptionAliasContract,type PmCommandOutputBudgetContract,type PmDiagnosticOutputBudgetContract,type PmCommandAliasContract } from "../cli-contracts.js";
+import { type ListCommandName,type ListProjectionMode } from "../query/list.js";
 import { type PmContextIntentContract } from "../context-intent-contracts.js";
 import { type PmReadOutputSurfaceContract } from "../read-output-contracts.js";
 import { type CliFlagInvocationContract } from "../flag-invocation-contracts.js";
 import { type PmCommandVisibilityTier } from "../agent-capability-contracts.js";
 import type { PmErrorCodeContract } from "../error-code-catalog.js";
 import { type PmCommandOutputEnvelopeContract } from "../output-contracts.js";
-import { type PmCommandExitContract, type PmCommandExitOutcomeContract } from "./command-exit-contracts.js";
-import { type PmCommandPositionalContract, type PmCommandDestinationContract } from "./grammar-contracts.js";
+import { type PmCommandExitContract,type PmCommandExitOutcomeContract } from "./command-exit-contracts.js";
+import { type PmCommandPositionalContract,type PmCommandDestinationContract } from "./grammar-contracts.js";
 /** Documents the contracts command options payload exchanged by command, SDK, and package integrations. */
 export interface ContractsCommandOptions {
 /** Value that configures or reports action for this contract. */
-action?: string;
+action?:string;
 /** Value that configures or reports command for this contract. */
-command?: string;
+command?:string;
 /** Value that configures or reports summary for this contract. */
-summary?: boolean;
+summary?:boolean;
 /** Value that configures or reports schema only for this contract. */
-schemaOnly?: boolean;
+schemaOnly?:boolean;
 /** Value that configures or reports flags only for this contract. */
-flagsOnly?: boolean;
+flagsOnly?:boolean;
 /** Value that configures or reports availability only for this contract. */
-availabilityOnly?: boolean;
+availabilityOnly?:boolean;
 /** Value that configures or reports runtime only for this contract. */
-runtimeOnly?: boolean;
+runtimeOnly?:boolean;
 /** Value that configures or reports full for this contract. */
-full?: boolean;
+full?:boolean;
 }
 interface CommandFlagSurface {
-command: string;
-canonical_command?: string;
-visibility?: PmCommandVisibilityTier;
-flags: CliFlagContract[];
-positionals?: PmCommandPositionalContract["slots"];
-flag_invocations?: CliFlagInvocationContract[];
-provider?: "core" | "extension" | "mixed";
-extension_sources?: Array<{
-layer: "global" | "project";
-name: string;
+command:string;
+canonical_command?:string;
+visibility?:PmCommandVisibilityTier;
+flags:CliFlagContract[];
+positionals?:PmCommandPositionalContract["slots"];
+flag_invocations?:CliFlagInvocationContract[];
+provider?:"core" | "extension" | "mixed";
+extension_sources?:Array<{
+layer:"global" | "project";
+name:string;
 }>;
 }
 /** Grouped command-alias projection retained for backward-compatible consumers. */
 export interface CommandAliasSurface {
 /** Canonical command path shared by the grouped aliases. */
-canonical: string;
+canonical:string;
 /** Accepted alternate spellings for the canonical path. */
-aliases: string[];
+aliases:string[];
 /** Per-spelling lifecycle, visibility, replacement, and ownership metadata. */
-contracts?: PmCommandAliasContract[];
+contracts?:PmCommandAliasContract[];
 }
 /** Machine-readable projection behavior for one list command. */
 interface ListCommandProjectionSurface {
-command: ListCommandName;
-default: Exclude<ListProjectionMode, "fields">;
-brief_fields: string[];
-compact_fields: string[];
+command:ListCommandName;
+default:Exclude<ListProjectionMode,"fields">;
+brief_fields:string[];
+compact_fields:string[];
 }
 /** Documents the contracts result payload exchanged by command, SDK, and package integrations. */
 export interface ContractsResult {
 /** Immutable event names, historical aliases, and package operation grammar. */
-history_operations?: typeof PM_HISTORY_OPERATION_CONTRACT;
+history_operations?:typeof PM_HISTORY_OPERATION_CONTRACT;
 /** Value that configures or reports schema version for this contract. */
-schema_version: string | null;
+schema_version:string | null;
 /** Value that configures or reports schema id for this contract. */
-schema_id: string | null;
+schema_id:string | null;
 /** Value that configures or reports selected for this contract. */
-selected: {
-action: string | null;
-command: string | null;
-summary: boolean;
-schema_only: boolean;
-flags_only: boolean;
-availability_only: boolean;
-runtime_only: boolean;
-command_scoped: boolean;
+selected:{
+action:string | null;
+command:string | null;
+summary:boolean;
+schema_only:boolean;
+flags_only:boolean;
+availability_only:boolean;
+runtime_only:boolean;
+command_scoped:boolean;
 };
 /** Value that configures or reports actions for this contract. */
-actions?: string[];
+actions?:string[];
 /** Value that configures or reports action availability for this contract. */
-action_availability?: ContractsActionAvailability[];
+action_availability?:ContractsActionAvailability[];
 /** Value that configures or reports commands for this contract. */
-commands: string[];
+commands:string[];
 /** Value that configures or reports schema for this contract. */
-schema?: Record<string, unknown>;
+schema?:Record<string,unknown>;
 /** Value that configures or reports schema omitted reason for this contract. */
-schema_omitted_reason?: string;
+schema_omitted_reason?:string;
 /** Value that configures or reports command flags omitted reason for this contract. */
-command_flags_omitted_reason?: string;
+command_flags_omitted_reason?:string;
 /** Value that configures or reports commander aliases omitted reason for this contract. */
-commander_aliases_omitted_reason?: string;
+commander_aliases_omitted_reason?:string;
 /** Value that configures or reports command flags for this contract. */
-command_flags?: CommandFlagSurface[];
+command_flags?:CommandFlagSurface[];
 /** Default and named field projections for list-family commands in scope. */
-list_projections?: ListCommandProjectionSurface[];
+list_projections?:ListCommandProjectionSurface[];
 /** Value that configures or reports command aliases for this contract. */
-command_aliases?: CommandAliasSurface[];
+command_aliases?:CommandAliasSurface[];
 /** Compact projections omit alias lifecycle metadata; restore it with --full. */
-command_alias_contracts_omitted_reason?: string;
+command_alias_contracts_omitted_reason?:string;
 /** Noun–verb routing policy and exhaustive current-command destinations. */
-grammar_contracts?: {
-nouns: readonly string[];
-shared_verbs: readonly string[];
-scope_before_verb: boolean;
-visible_top_level_ceiling: number;
-ceiling_raise_requires_pm_item: boolean;
-positional_shape_budget: number;
-positional_shape_count: number;
-positional_action_count: number;
-positional_action_parents: readonly string[];
-positional_signatures?: readonly PmCommandPositionalContract[];
-destinations?: readonly PmCommandDestinationContract[];
+grammar_contracts?:{
+nouns:readonly string[];
+shared_verbs:readonly string[];
+scope_before_verb:boolean;
+visible_top_level_ceiling:number;
+ceiling_raise_requires_pm_item:boolean;
+positional_shape_budget:number;
+positional_shape_count:number;
+positional_action_count:number;
+positional_action_parents:readonly string[];
+positional_signatures?:readonly PmCommandPositionalContract[];
+destinations?:readonly PmCommandDestinationContract[];
 };
 /** Value that configures or reports commander aliases for this contract. */
-commander_aliases?: Record<string, CommanderOptionAliasContract[]>;
+commander_aliases?:Record<string,CommanderOptionAliasContract[]>;
 /** Value that configures or reports extension commands for this contract. */
-extension_commands?: ExtensionCommandContract[];
+extension_commands?:ExtensionCommandContract[];
 /** Value that configures or reports command summaries for this contract. */
-command_summaries?: CommandSummarySurface[];
+command_summaries?:CommandSummarySurface[];
 /** Shared deterministic degradation policy for command output budgets. */
-output_policy?: {
-token_estimate: "ceil(utf8_bytes / 4)";
-degradation_ladder: string[];
-allows_unbounded_opt_out: boolean;
+output_policy?:{
+token_estimate:"ceil(utf8_bytes / 4)";
+degradation_ladder:string[];
+allows_unbounded_opt_out:boolean;
 };
 /** Exact per-command projection vocabularies and the scope of the compatibility union. */
-output_projection_contracts?: {
-global_ladder_field: "output_policy.degradation_ladder";
-global_ladder_scope: "union_not_per_command";
-discovery: "pm contracts --command <command> --summary";
-commands?: Array<{
-command: string;
-modes: string[];
+output_projection_contracts?:{
+global_ladder_field:"output_policy.degradation_ladder";
+global_ladder_scope:"union_not_per_command";
+discovery:"pm contracts --command <command> --summary";
+commands?:Array<{
+command:string;
+modes:string[];
 }>;
 };
 /** Value that configures or reports runtime schema for this contract. */
-runtime_schema?: {
-statuses: string[];
-open_status: string;
-close_status: string;
-canceled_status: string;
-types: string[];
-fields_by_command: Record<string, string[]>;
+runtime_schema?:{
+statuses:string[];
+open_status:string;
+close_status:string;
+canceled_status:string;
+types:string[];
+fields_by_command:Record<string,string[]>;
 };
 /** Canonical relationship ontology and accepted compatibility aliases. */
-relationship_kind_contracts?: Array<{
-canonical: string;
-aliases: string[];
-inverse?: string;
-ordering: boolean;
-hierarchy: boolean;
+relationship_kind_contracts?:Array<{
+canonical:string;
+aliases:string[];
+inverse?:string;
+ordering:boolean;
+hierarchy:boolean;
 }>;
 /** Value that configures or reports extension contracts for this contract. */
-extension_contracts?: {
-capabilities: string[];
-services: string[];
-policy_modes: string[];
+extension_contracts?:{
+capabilities:string[];
+services:string[];
+policy_modes:string[];
 /** Settings path governed by policy_modes; prevents conflation with workflow governance. */
-policy_mode_scope: "extensions.policy.mode";
-policy_surfaces: string[];
-trust_modes: string[];
+policy_mode_scope:"extensions.policy.mode";
+policy_surfaces:string[];
+trust_modes:string[];
 /** Settings path governed by trust_modes. */
-trust_mode_scope: "extensions.policy.trust_mode";
-sandbox_profiles: string[];
-manifest_versions: number[];
-compatibility: {
-current: string;
-previous: string[];
-breaking_strategy: string;
+trust_mode_scope:"extensions.policy.trust_mode";
+sandbox_profiles:string[];
+manifest_versions:number[];
+compatibility:{
+current:string;
+previous:string[];
+breaking_strategy:string;
 };
 };
 /** Canonical value domains accepted by project governance config setters. */
-governance_contracts?: {
-ownership_enforcement_modes: string[];
-create_modes: string[];
-close_validation_modes: string[];
-workflow_enforcement_modes: string[];
+governance_contracts?:{
+ownership_enforcement_modes:string[];
+create_modes:string[];
+close_validation_modes:string[];
+workflow_enforcement_modes:string[];
 };
 /** Authoritative assurance declaration vocabularies for SDK and host validation. */
-assurance_contracts?: {
-measurement_source_kinds: readonly string[];
-gate_triggers: readonly string[];
+assurance_contracts?:{
+measurement_source_kinds:readonly string[];
+gate_triggers:readonly string[];
 };
 /** Value that configures or reports mcp tools for this contract. */
-mcp_tools?: McpToolContract[];
+mcp_tools?:McpToolContract[];
 /** Built-in intent-scoped read projections available to CLI, SDK, MCP, and package consumers. */
-context_intents?: readonly PmContextIntentContract[];
+context_intents?:readonly PmContextIntentContract[];
 /** Canonical include, amount, cost, and encoding contracts for every built-in read surface. */
-read_output_dimensions?: readonly PmReadOutputSurfaceContract[];
+read_output_dimensions?:readonly PmReadOutputSurfaceContract[];
 /** Exhaustive stable and provisional machine-readable failure vocabulary. */
-error_codes?: readonly PmErrorCodeContract[];
+error_codes?:readonly PmErrorCodeContract[];
 /** Format-aware budgets and envelope families for every active command. */
-command_output_contracts?: Array<{
-budget: PmCommandOutputBudgetContract;
-envelope: PmCommandOutputEnvelopeContract;
+command_output_contracts?:Array<{
+budget:PmCommandOutputBudgetContract;
+envelope:PmCommandOutputEnvelopeContract;
 }>;
 /** Binding ceilings and action-preserving degradation for diagnostic families. */
-diagnostic_output_contracts?: readonly PmDiagnosticOutputBudgetContract[];
+diagnostic_output_contracts?:readonly PmDiagnosticOutputBudgetContract[];
 /** Stable outcome vocabulary and exhaustive per-command process exit sets. */
-command_exit_contracts?: {
-vocabulary: readonly PmCommandExitOutcomeContract[];
-command_sets: Array<{
-commands: string[];
-exit_codes: PmCommandExitContract["exit_codes"];
+command_exit_contracts?:{
+vocabulary:readonly PmCommandExitOutcomeContract[];
+command_sets:Array<{
+commands:string[];
+exit_codes:PmCommandExitContract["exit_codes"];
 }>;
 };
 }
@@ -212,166 +212,166 @@ type PmToolAction = (typeof PM_TOOL_ACTIONS)[number];
 /** Documents the contracts action availability payload exchanged by command, SDK, and package integrations. */
 export interface ContractsActionAvailability {
 /** Value that configures or reports action for this contract. */
-action: string;
+action:string;
 /** Value that configures or reports invocable for this contract. */
-invocable: boolean;
+invocable:boolean;
 /** Value that configures or reports available for this contract. */
-available: boolean;
+available:boolean;
 /** Value that configures or reports requires extension for this contract. */
-requires_extension: boolean;
+requires_extension:boolean;
 /** Value that configures or reports provider for this contract. */
-provider: "core" | "extension";
+provider:"core" | "extension";
 /** Value that configures or reports disabled reason for this contract. */
-disabled_reason: string | null;
+disabled_reason:string | null;
 /** Filesystem path used for command resolution. */
-command_path: string | null;
+command_path:string | null;
 /** Value that configures or reports cli exposed for this contract. */
-cli_exposed: boolean;
+cli_exposed:boolean;
 /** Value that configures or reports policy state for this contract. */
-policy_state?: {
-mode: string;
-trust_mode: string;
-default_sandbox_profile: string;
+policy_state?:{
+mode:string;
+trust_mode:string;
+default_sandbox_profile:string;
 };
 }
 interface RuntimeExtensionActionProbe {
-handlers: Set<string>;
-disabledReason: string | null;
-commandDefinitions: RegisteredExtensionCommandDefinition[];
-flagRegistrations: RegisteredExtensionFlagDefinitions[];
-registrations: ExtensionRegistrationRegistry | null;
-policyState: {
-mode: string;
-trust_mode: string;
-default_sandbox_profile: string;
+handlers:Set<string>;
+disabledReason:string | null;
+commandDefinitions:RegisteredExtensionCommandDefinition[];
+flagRegistrations:RegisteredExtensionFlagDefinitions[];
+registrations:ExtensionRegistrationRegistry | null;
+policyState:{
+mode:string;
+trust_mode:string;
+default_sandbox_profile:string;
 };
 }
 interface ExtensionCommandContract {
 /** Read-only structured output declaration contributed by the package. */
-read_output?: RegisteredExtensionCommandDefinition["read_output"];
+read_output?:RegisteredExtensionCommandDefinition["read_output"];
 /** Package-declared discovery tier, retained for full and scoped inspection. */
-tier?: PmCommandVisibilityTier;
-command: string;
-action: string;
-source: {
-layer: "global" | "project";
-name: string;
+tier?:PmCommandVisibilityTier;
+command:string;
+action:string;
+source:{
+layer:"global" | "project";
+name:string;
 } | null;
-description: string | null;
-intent: string | null;
-arguments: Array<{
-name: string;
-required: boolean;
-variadic: boolean;
-description: string | null;
+description:string | null;
+intent:string | null;
+arguments:Array<{
+name:string;
+required:boolean;
+variadic:boolean;
+description:string | null;
 }>;
-flags: CliFlagContract[];
-examples: string[];
-failure_hints: string[];
+flags:CliFlagContract[];
+examples:string[];
+failure_hints:string[];
 }
 interface CommandSummarySurface {
-command: string;
-aliases?: string[];
-intent: string;
+command:string;
+aliases?:string[];
+intent:string;
 /** Non-default provenance in compact output; exhaustive provenance in full output. */
-intent_source?: "command" | "description" | "generated";
-flags?: string[];
-default_max_estimated_tokens: number;
+intent_source?:"command" | "description" | "generated";
+flags?:string[];
+default_max_estimated_tokens:number;
 /** Full-projection format detail; compact summaries retain the canonical default only. */
-default_max_estimated_tokens_by_format?: {
-toon: number;
-json: number;
+default_max_estimated_tokens_by_format?:{
+toon:number;
+json:number;
 };
 }
-declare function packageOwnedActionForCommand(command: string): string;
+declare function packageOwnedActionForCommand(command:string):string;
 /** Project stable SDK/MCP actions into discoverable CLI paths, retaining native and legacy spellings. */
-declare function resolveActionCommandPath(action: PmToolAction): string | null;
+declare function resolveActionCommandPath(action:PmToolAction):string | null;
 /** Select the exact history operation or a compatible parent/child path when filtering action descriptors. */
-declare function actionDescriptorMatchesSelectedCommand(descriptor: ActionContractDescriptor, selectedCommand: string): boolean;
-declare function splitCommandPathAliases(commandPath: string): string[];
-declare function resolveScopedCommandsFromActionDescriptors(descriptors: ActionContractDescriptor[], commandCatalog: string[]): string[];
-declare function extractActionBranches(schema: Record<string, unknown>): Record<string, unknown>[];
-declare function filterSchemaByAction(schema: Record<string, unknown>, action: string | undefined): Record<string, unknown>;
-declare function filterSchemaByActions(schema: Record<string, unknown>, actions: ReadonlySet<string>): Record<string, unknown>;
-declare function normalizeCommandPath(value: string): string;
-declare function normalizeActionNameFromCommand(commandPath: string): string;
-declare function normalizeExtensionFlagName(value: unknown, kind: "long" | "short"): string | null;
-declare function collectExtensionFlagContractsByCommand(registrations: RegisteredExtensionFlagDefinitions[]): Map<string, {
-flags: CliFlagContract[];
-sources: Array<{
-layer: "global" | "project";
-name: string;
+declare function actionDescriptorMatchesSelectedCommand(descriptor:ActionContractDescriptor,selectedCommand:string):boolean;
+declare function splitCommandPathAliases(commandPath:string):string[];
+declare function resolveScopedCommandsFromActionDescriptors(descriptors:ActionContractDescriptor[],commandCatalog:string[]):string[];
+declare function extractActionBranches(schema:Record<string,unknown>):Record<string,unknown>[];
+declare function filterSchemaByAction(schema:Record<string,unknown>,action:string | undefined):Record<string,unknown>;
+declare function filterSchemaByActions(schema:Record<string,unknown>,actions:ReadonlySet<string>):Record<string,unknown>;
+declare function normalizeCommandPath(value:string):string;
+declare function normalizeActionNameFromCommand(commandPath:string):string;
+declare function normalizeExtensionFlagName(value:unknown,kind:"long" | "short"):string | null;
+declare function collectExtensionFlagContractsByCommand(registrations:RegisteredExtensionFlagDefinitions[]):Map<string,{
+flags:CliFlagContract[];
+sources:Array<{
+layer:"global" | "project";
+name:string;
 }>;
 }>;
 /** Preserve registered package metadata and combine handler, argument, and flag contributions by command path. */
-declare function collectExtensionCommandContracts(runtimeProbe: RuntimeExtensionActionProbe): ExtensionCommandContract[];
-declare function extensionSchemaPropertyNameFromFlag(flag: CliFlagContract): string | null;
-declare function buildExtensionActionSchemaBranch(contract: ExtensionCommandContract): Record<string, unknown>;
-declare function mergeExtensionContractsByAction(contracts: ExtensionCommandContract[]): ExtensionCommandContract[];
-declare function resolveRuntimeExtensionActionProbe(global: GlobalOptions, readSettingsFn?: typeof readSettings): Promise<RuntimeExtensionActionProbe>;
+declare function collectExtensionCommandContracts(runtimeProbe:RuntimeExtensionActionProbe):ExtensionCommandContract[];
+declare function extensionSchemaPropertyNameFromFlag(flag:CliFlagContract):string | null;
+declare function buildExtensionActionSchemaBranch(contract:ExtensionCommandContract):Record<string,unknown>;
+declare function mergeExtensionContractsByAction(contracts:ExtensionCommandContract[]):ExtensionCommandContract[];
+declare function resolveRuntimeExtensionActionProbe(global:GlobalOptions,readSettingsFn?:typeof readSettings):Promise<RuntimeExtensionActionProbe>;
 interface ActionContractDescriptor {
-action: string;
-provider: "core" | "extension";
-requires_extension: boolean;
-command_path: string | null;
+action:string;
+provider:"core" | "extension";
+requires_extension:boolean;
+command_path:string | null;
 }
 /** Merge stable core and package action identities with canonical command paths for contract discovery. */
-declare function collectActionContractDescriptors(extensionContracts: ExtensionCommandContract[], options?: {
-includePackageOwnedActions?: boolean;
-}): ActionContractDescriptor[];
+declare function collectActionContractDescriptors(extensionContracts:ExtensionCommandContract[],options?:{
+includePackageOwnedActions?:boolean;
+}):ActionContractDescriptor[];
 /** Derive invocability from active handlers and policy, preserving installation hints for unavailable optional operations. */
-declare function resolveActionAvailability(descriptor: ActionContractDescriptor, runtimeProbe: RuntimeExtensionActionProbe): ContractsActionAvailability;
-declare function resolveCoreCommandFlags(command: string): CliFlagContract[];
+declare function resolveActionAvailability(descriptor:ActionContractDescriptor,runtimeProbe:RuntimeExtensionActionProbe):ContractsActionAvailability;
+declare function resolveCoreCommandFlags(command:string):CliFlagContract[];
 /** Recognize core flag contracts while keeping package-owned operations outside the core provider surface. */
-declare function isCoreCommandPath(command: string): boolean;
-declare function normalizeCommandForRuntimeFieldFlags(command: string): string;
-declare function toRuntimeLongFlagToken(token: string): string | null;
-declare function toRuntimeShortFlagToken(token: string): string | null;
-declare function buildRuntimeFieldFlagContracts(fieldRegistry: RuntimeFieldRegistry): Map<string, CliFlagContract[]>;
+declare function isCoreCommandPath(command:string):boolean;
+declare function normalizeCommandForRuntimeFieldFlags(command:string):string;
+declare function toRuntimeLongFlagToken(token:string):string | null;
+declare function toRuntimeShortFlagToken(token:string):string | null;
+declare function buildRuntimeFieldFlagContracts(fieldRegistry:RuntimeFieldRegistry):Map<string,CliFlagContract[]>;
 /** Build the executable alias projection from a command catalog and alias table. */
-export declare function buildCommandAliasSurface(commands: string[], aliasContracts?: readonly PmCommandAliasContract[]): CommandAliasSurface[];
-declare function attachCreateRequiredOptionContracts(schema: Record<string, unknown>, metadata: Record<string, unknown>): Record<string, unknown>;
-declare function readContractsSettings(pmRoot: string, readSettingsFn?: typeof readSettings): Promise<Awaited<ReturnType<typeof readSettings>>>;
+export declare function buildCommandAliasSurface(commands:string[],aliasContracts?:readonly PmCommandAliasContract[]):CommandAliasSurface[];
+declare function attachCreateRequiredOptionContracts(schema:Record<string,unknown>,metadata:Record<string,unknown>):Record<string,unknown>;
+declare function readContractsSettings(pmRoot:string,readSettingsFn?:typeof readSettings):Promise<Awaited<ReturnType<typeof readSettings>>>;
 /** Build stable agent summaries with available bootstrap flags and independently selectable budget and intent metadata. */
-declare function buildCommandSummarySurface(commands: readonly string[], extensionContracts?: readonly ExtensionCommandContract[], options?: {
-includeFormatBudgets?: boolean;
-includeIntentProvenance?: boolean;
-}): CommandSummarySurface[];
-declare function buildCommandOutputContracts(commands: readonly string[]): NonNullable<ContractsResult["command_output_contracts"]>;
-declare function buildCommandExitContractGroups(commands: readonly string[]): NonNullable<ContractsResult["command_exit_contracts"]>["command_sets"];
+declare function buildCommandSummarySurface(commands:readonly string[],extensionContracts?:readonly ExtensionCommandContract[],options?:{
+includeFormatBudgets?:boolean;
+includeIntentProvenance?:boolean;
+}):CommandSummarySurface[];
+declare function buildCommandOutputContracts(commands:readonly string[]):NonNullable<ContractsResult["command_output_contracts"]>;
+declare function buildCommandExitContractGroups(commands:readonly string[]):NonNullable<ContractsResult["command_exit_contracts"]>["command_sets"];
 /** Assemble the requested command or action projection from the active SDK registry without exposing internal paths in default discovery. */
-export declare function runContracts(options: ContractsCommandOptions, global: GlobalOptions): Promise<ContractsResult>;
+export declare function runContracts(options:ContractsCommandOptions,global:GlobalOptions):Promise<ContractsResult>;
 /** Public contract for test only contracts command, shared by SDK and presentation-layer consumers. */
-export declare const _testOnlyContractsCommand: {
-actionDescriptorMatchesSelectedCommand: typeof actionDescriptorMatchesSelectedCommand;
-attachCreateRequiredOptionContracts: typeof attachCreateRequiredOptionContracts;
-buildExtensionActionSchemaBranch: typeof buildExtensionActionSchemaBranch;
-buildCommandSummarySurface: typeof buildCommandSummarySurface;
-buildCommandOutputContracts: typeof buildCommandOutputContracts;
-buildCommandExitContractGroups: typeof buildCommandExitContractGroups;
-buildRuntimeFieldFlagContracts: typeof buildRuntimeFieldFlagContracts;
-collectActionContractDescriptors: typeof collectActionContractDescriptors;
-collectExtensionCommandContracts: typeof collectExtensionCommandContracts;
-collectExtensionFlagContractsByCommand: typeof collectExtensionFlagContractsByCommand;
-extractActionBranches: typeof extractActionBranches;
-extensionSchemaPropertyNameFromFlag: typeof extensionSchemaPropertyNameFromFlag;
-filterSchemaByAction: typeof filterSchemaByAction;
-filterSchemaByActions: typeof filterSchemaByActions;
-isCoreCommandPath: typeof isCoreCommandPath;
-mergeExtensionContractsByAction: typeof mergeExtensionContractsByAction;
-normalizeExtensionFlagName: typeof normalizeExtensionFlagName;
-normalizeActionNameFromCommand: typeof normalizeActionNameFromCommand;
-normalizeCommandForRuntimeFieldFlags: typeof normalizeCommandForRuntimeFieldFlags;
-normalizeCommandPath: typeof normalizeCommandPath;
-packageOwnedActionForCommand: typeof packageOwnedActionForCommand;
-readContractsSettings: typeof readContractsSettings;
-resolveActionCommandPath: typeof resolveActionCommandPath;
-resolveActionAvailability: typeof resolveActionAvailability;
-resolveCoreCommandFlags: typeof resolveCoreCommandFlags;
-resolveRuntimeExtensionActionProbe: typeof resolveRuntimeExtensionActionProbe;
-resolveScopedCommandsFromActionDescriptors: typeof resolveScopedCommandsFromActionDescriptors;
-splitCommandPathAliases: typeof splitCommandPathAliases;
-toRuntimeLongFlagToken: typeof toRuntimeLongFlagToken;
-toRuntimeShortFlagToken: typeof toRuntimeShortFlagToken;
+export declare const _testOnlyContractsCommand:{
+actionDescriptorMatchesSelectedCommand:typeof actionDescriptorMatchesSelectedCommand;
+attachCreateRequiredOptionContracts:typeof attachCreateRequiredOptionContracts;
+buildExtensionActionSchemaBranch:typeof buildExtensionActionSchemaBranch;
+buildCommandSummarySurface:typeof buildCommandSummarySurface;
+buildCommandOutputContracts:typeof buildCommandOutputContracts;
+buildCommandExitContractGroups:typeof buildCommandExitContractGroups;
+buildRuntimeFieldFlagContracts:typeof buildRuntimeFieldFlagContracts;
+collectActionContractDescriptors:typeof collectActionContractDescriptors;
+collectExtensionCommandContracts:typeof collectExtensionCommandContracts;
+collectExtensionFlagContractsByCommand:typeof collectExtensionFlagContractsByCommand;
+extractActionBranches:typeof extractActionBranches;
+extensionSchemaPropertyNameFromFlag:typeof extensionSchemaPropertyNameFromFlag;
+filterSchemaByAction:typeof filterSchemaByAction;
+filterSchemaByActions:typeof filterSchemaByActions;
+isCoreCommandPath:typeof isCoreCommandPath;
+mergeExtensionContractsByAction:typeof mergeExtensionContractsByAction;
+normalizeExtensionFlagName:typeof normalizeExtensionFlagName;
+normalizeActionNameFromCommand:typeof normalizeActionNameFromCommand;
+normalizeCommandForRuntimeFieldFlags:typeof normalizeCommandForRuntimeFieldFlags;
+normalizeCommandPath:typeof normalizeCommandPath;
+packageOwnedActionForCommand:typeof packageOwnedActionForCommand;
+readContractsSettings:typeof readContractsSettings;
+resolveActionCommandPath:typeof resolveActionCommandPath;
+resolveActionAvailability:typeof resolveActionAvailability;
+resolveCoreCommandFlags:typeof resolveCoreCommandFlags;
+resolveRuntimeExtensionActionProbe:typeof resolveRuntimeExtensionActionProbe;
+resolveScopedCommandsFromActionDescriptors:typeof resolveScopedCommandsFromActionDescriptors;
+splitCommandPathAliases:typeof splitCommandPathAliases;
+toRuntimeLongFlagToken:typeof toRuntimeLongFlagToken;
+toRuntimeShortFlagToken:typeof toRuntimeShortFlagToken;
 };
 export {};