API Reference
ToolRepresentativeExamples
Shared helpers for collecting declared representative tool examples and composing generic fallback examples.
Inheritance
- Object
- ToolRepresentativeExamples
Methods
public static Void AppendFallbackExamples<T>(List<String> examples, IReadOnlyList<T?> items, params ValueTuple<Func<T?, Boolean>, String>[] rules) #VoidAppends ordered fallback examples for the first matching predicates that apply.
Type Parameters
- T
Parameters
- examples System.Collections.Generic.List<System.String>
- items System.Collections.Generic.IReadOnlyList<T?>
- rules System.ValueTuple<System.Func<T?, System.Boolean>, System.String>[]
public static Void AppendFallbackExamples<T>(List<String> examples, IReadOnlyList<T?> items, Int32 maxExamples, params ValueTuple<Func<T?, Boolean>, String>[] rules) #VoidAppends ordered fallback examples for the first matching predicates that apply.
Type Parameters
- T
Parameters
- examples System.Collections.Generic.List<System.String>
- items System.Collections.Generic.IReadOnlyList<T?>
- maxExamples System.Int32
- rules System.ValueTuple<System.Func<T?, System.Boolean>, System.String>[]
public static String BuildCrossPackAvailabilityLine(IReadOnlyList<String> displayNames, String availabilityQualifier) #StringFormats a cross-pack availability line for capability guidance.
Parameters
- displayNames System.Collections.Generic.IReadOnlyList<System.String>
- availabilityQualifier System.String
public static String BuildCrossPackPivotExample(IReadOnlyList<String> displayNames) #StringFormats a representative cross-pack follow-up example for capability prompts.
Parameters
- displayNames System.Collections.Generic.IReadOnlyList<System.String>
public static String BuildCrossPackSummary(IReadOnlyList<String> displayNames) #StringFormats a compact cross-pack summary for planner hints.
Parameters
- displayNames System.Collections.Generic.IReadOnlyList<System.String>
public static List<String> CollectDeclaredExamples<T>(IReadOnlyList<T?> items, Func<T?, IReadOnlyList<String>?> examplesSelector, Int32 maxExamples = 4) #List<String>Collects declared representative examples from items while trimming, de-duplicating, and honoring the cap.
Type Parameters
- T
Parameters
- items System.Collections.Generic.IReadOnlyList<T?>
- examplesSelector System.Func<T?, System.Collections.Generic.IReadOnlyList<System.String>?>
- maxExamples System.Int32 = 4
public static List<String> CollectTargetDisplayNames<T>(IReadOnlyList<T?> items, Func<T?, IReadOnlyList<String>?> targetIdsSelector, Func<String?, String> normalizeTargetId, Func<String, String> resolveDisplayName) #List<String>Collects distinct normalized display names from item target ids and returns them sorted.
Type Parameters
- T
Parameters
- items System.Collections.Generic.IReadOnlyList<T?>
- targetIdsSelector System.Func<T?, System.Collections.Generic.IReadOnlyList<System.String>?>
- normalizeTargetId System.Func<System.String?, System.String>
- resolveDisplayName System.Func<System.String, System.String>
public static Boolean IsDirectoryScopeFallbackCandidate(Boolean isEnvironmentDiscoverTool, String? scope, Boolean supportsTargetScoping, IReadOnlyList<String>? targetScopeArguments) #BooleanReturns true when the provided traits look like a directory-scope discovery flow.
Parameters
- isEnvironmentDiscoverTool System.Boolean
- scope System.String?
- supportsTargetScoping System.Boolean
- targetScopeArguments System.Collections.Generic.IReadOnlyList<System.String>?
public static Boolean IsEventEvidenceFallbackCandidate(String? entity, Boolean supportsRemoteHostTargeting, Boolean supportsRemoteExecution, String? executionScope) #BooleanReturns true when the provided traits look like an event-evidence workflow.
Parameters
- entity System.String?
- supportsRemoteHostTargeting System.Boolean
- supportsRemoteExecution System.Boolean
- executionScope System.String?
public static Boolean IsHostDiagnosticsFallbackCandidate(String? scope, String? entity, Boolean supportsRemoteHostTargeting, Boolean supportsRemoteExecution, String? executionScope) #BooleanReturns true when the provided traits look like a host-diagnostics workflow.
Parameters
- scope System.String?
- entity System.String?
- supportsRemoteHostTargeting System.Boolean
- supportsRemoteExecution System.Boolean
- executionScope System.String?
public static Boolean TryAddExample(List<String> examples, String? example, Int32 maxExamples = 4) #BooleanAdds an example when it is non-empty, unique, and the target has not reached the requested cap.
Parameters
- examples System.Collections.Generic.List<System.String>
- example System.String?
- maxExamples System.Int32 = 4
Inherited Methods
public virtual Boolean Equals(Object? obj) #BooleanParameters
- obj Object?
Fields
public const String DirectoryScopeFallbackExample #Generic fallback example for directory-scoped discovery flows.
discover directory scope, search directory objects, and target a specific domain controller or base DNpublic const String EventEvidenceFallbackExample #Generic fallback example for event-evidence flows.
inspect event logs and summarize recurring failures on this machine or a reachable hostpublic const String HostDiagnosticsFallbackExample #Generic fallback example for host diagnostics flows.
collect system inventory plus CPU, memory, and disk health locally or on reachable machinespublic const String SetupAwareFallbackExample #Generic fallback example for setup-aware flows.
use built-in setup or preflight helpers before deeper checks when a workflow needs environment contextpublic const String PackInfoFallbackExample #Generic fallback example for pack-overview flows.
summarize the currently loaded tool areas before choosing the next check