API Reference
Class
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, Int32 maxExamples, params ValueTuple<Func<T, Boolean>, String>[] rules) #Returns:
VoidType Parameters
- T
Parameters
- examples List<String>
- items IReadOnlyList<T>
- rules ValueTuple<Func<T, Boolean>, String>[]
AppendFallbackExamples``1 2 overloads
AppendFallbackExamples``1(System.Collections.Generic.List{System.String} examples, System.Collections.Generic.IReadOnlyList{``0} items, System.ValueTuple{System.Func{``0,System.Boolean},System.String}[] rules) #Appends ordered fallback examples for the first matching predicates that apply.
Parameters
- examples System.Collections.Generic.List{System.String}
- items System.Collections.Generic.IReadOnlyList{``0}
- rules System.ValueTuple{System.Func{``0,System.Boolean},System.String}[]
AppendFallbackExamples``1(System.Collections.Generic.List{System.String} examples, System.Collections.Generic.IReadOnlyList{``0} items, System.Int32 maxExamples, System.ValueTuple{System.Func{``0,System.Boolean},System.String}[] rules) #Appends ordered fallback examples for the first matching predicates that apply.
Parameters
- examples System.Collections.Generic.List{System.String}
- items System.Collections.Generic.IReadOnlyList{``0}
- maxExamples System.Int32
- rules System.ValueTuple{System.Func{``0,System.Boolean},System.String}[]
public static String BuildCrossPackAvailabilityLine(IReadOnlyList<String> displayNames, String availabilityQualifier) #Returns:
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) #Returns:
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) #Returns:
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) #Returns:
List<String>Type Parameters
- T
Parameters
- items IReadOnlyList<T>
- examplesSelector Func<T, IReadOnlyList<String>>
- maxExamples Int32 = 4
CollectDeclaredExamples``1(System.Collections.Generic.IReadOnlyList{``0} items, System.Func{``0,System.Collections.Generic.IReadOnlyList{System.String}} examplesSelector, System.Int32 maxExamples) #Collects declared representative examples from items while trimming, de-duplicating, and honoring the cap.
Parameters
- items System.Collections.Generic.IReadOnlyList{``0}
- examplesSelector System.Func{``0,System.Collections.Generic.IReadOnlyList{System.String}}
- maxExamples System.Int32
public static List<String> CollectTargetDisplayNames<T>(IReadOnlyList<T> items, Func<T, IReadOnlyList<String>> targetIdsSelector, Func<String, String> normalizeTargetId, Func<String, String> resolveDisplayName) #Returns:
List<String>Type Parameters
- T
Parameters
- items IReadOnlyList<T>
- targetIdsSelector Func<T, IReadOnlyList<String>>
- normalizeTargetId Func<String, String>
- resolveDisplayName Func<String, String>
CollectTargetDisplayNames``1(System.Collections.Generic.IReadOnlyList{``0} items, System.Func{``0,System.Collections.Generic.IReadOnlyList{System.String}} targetIdsSelector, System.Func{System.String,System.String} normalizeTargetId, System.Func{System.String,System.String} resolveDisplayName) #Collects distinct normalized display names from item target ids and returns them sorted.
Parameters
- items System.Collections.Generic.IReadOnlyList{``0}
- targetIdsSelector System.Func{``0,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) #Returns:
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) #Returns:
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) #Returns:
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) #Returns:
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 override Boolean Equals(Object obj) #Returns:
BooleanInherited from Object
Parameters
- obj Object
Fields
public const String DirectoryScopeFallbackExample #Generic fallback example for directory-scoped discovery flows.
Value:
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.
Value:
inspect event logs and summarize recurring failures on this machine or a reachable hostpublic const String HostDiagnosticsFallbackExample #Generic fallback example for host diagnostics flows.
Value:
collect system inventory plus CPU, memory, and disk health locally or on reachable machinespublic const String SetupAwareFallbackExample #Generic fallback example for setup-aware flows.
Value:
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.
Value:
summarize the currently loaded tool areas before choosing the next check