TechToolbox.psd1
|
# # Module manifest for module 'TechToolbox' # # Generated by: Dan Damit # # Generated on: 9/6/2026 # @{ # Script module or binary module file associated with this manifest. RootModule = 'TechToolbox.psm1' # Version number of this module. ModuleVersion = '0.5.118' # Supported PSEditions CompatiblePSEditions = 'Core' # ID used to uniquely identify this module GUID = '5bfe2119-e8be-4ac4-8183-7ebc7400058c' # Author of this module Author = 'Dan Damit' # Company or vendor of this module CompanyName = 'Value Added Companies' # Copyright statement for this module Copyright = '(c) Dan Damit. All rights reserved.' # Description of the functionality provided by this module Description = 'A technician-grade toolbox for automation, diagnostics, and enterprise workflows. Invoke-TechAgent now supports OpenAI API key usage for cloud-based inference, allowing operators to leverage the TechAgent workflows without local inference requirements. First time users should start with Get-TechToolboxConfig and Get-ToolboxHelp. TechToolbox also utilizes the conventional PowerShell help system, so Get-Help <command-name> is your friend.' # Minimum version of the PowerShell engine required by this module PowerShellVersion = '7.6.5' # Name of the PowerShell host required by this module # PowerShellHostName = '' # Minimum version of the PowerShell host required by this module # PowerShellHostVersion = '' # Minimum version of Microsoft .NET Framework required by this module. This prerequisite is valid for the PowerShell Desktop edition only. # DotNetFrameworkVersion = '' # Minimum version of the common language runtime (CLR) required by this module. This prerequisite is valid for the PowerShell Desktop edition only. # ClrVersion = '' # Processor architecture (None, X86, Amd64) required by this module # ProcessorArchitecture = '' # Modules that must be imported into the global environment prior to importing this module # RequiredModules = @() # Assemblies that must be loaded prior to importing this module # RequiredAssemblies = @() # Script files (.ps1) that are run in the caller's environment prior to importing this module. # ScriptsToProcess = @() # Type files (.ps1xml) to be loaded when importing this module # TypesToProcess = @() # Format files (.ps1xml) to be loaded when importing this module # FormatsToProcess = @() # Modules to import as nested modules of the module specified in RootModule/ModuleToProcess # NestedModules = @() # Functions to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no functions to export. FunctionsToExport = 'Clear-BrowserProfileData', 'Copy-Directory', 'Disable-User', 'Enable-NetFx3', 'Export-ToolboxFunctions', 'Find-LargeFiles', 'Get-AllUsers', 'Get-AuditSharedMailboxDeletions', 'Get-AutodiscoverXmlInteractive', 'Get-BatteryHealth', 'Get-CUCredentialManagerContents', 'Get-DomainAdminCredential', 'Get-ErrorEvents', 'Get-FilesUsingKeywords', 'Get-InstalledPrinters', 'Get-LocalAdminMembers', 'Get-MessageTrace', 'Get-PDQDiagLogs', 'Get-RemoteInstalledSoftware', 'Get-SharedMailboxPermissions', 'Get-SystemSnapshot', 'Get-SystemTrustDiagnostic', 'Get-SystemUptime', 'Get-TechAgentQualitySummary', 'Get-TechToolboxConfig', 'Get-ToolboxHelp', 'Get-WindowsProductKey', 'Initialize-TTWordList', 'Install-TechAgentRuntime', 'Invoke-AADSyncRemote', 'Invoke-DownloadsCleanup', 'Invoke-PurviewPurge', 'Invoke-RestartService', 'Invoke-SubnetScan', 'Invoke-SystemRepair', 'Invoke-TechAgent', 'New-OnPremUserFromTemplate', 'Remove-EpicorEdgeAgent', 'Remove-Printers', 'Reset-ADPassword', 'Reset-WindowsUpdateComponents', 'Search-User', 'Set-EmailAlias', 'Set-OneTimeReboot', 'Set-PageFileSize', 'Set-ProxyAddress', 'Set-TechAgentApiKey', 'Set-TechAgentSearchWebApiKey', 'Start-DnsQueryLogger', 'Start-NewPSRemoteSession', 'Start-PDQDiagLocalElevated', 'Stop-PSRemoteSession', 'Test-MailHeaderAuth', 'Test-PathAs', 'Test-TechAgentProvider', 'Test-TTPathRoots', 'Use-TechAgentTaskTemplate', 'Watch-ISPConnection' # Cmdlets to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no cmdlets to export. CmdletsToExport = '*' # Variables to export from this module VariablesToExport = '*' # Aliases to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no aliases to export. AliasesToExport = @() # DSC resources to export from this module # DscResourcesToExport = @() # List of all modules packaged with this module # ModuleList = @() # List of all files packaged with this module # FileList = @() # Private data to pass to the module specified in RootModule/ModuleToProcess. This may also contain a PSData hashtable with additional module metadata used by PowerShell. PrivateData = @{ #TechToolbox of this module TechToolbox = 'System.Collections.Hashtable' PSData = @{ # Tags applied to this module. These help with module discovery in online galleries. Tags = 'automation','networking','diagnostics','toolbox','troubleshooting','enterprise','sysadmin','itpro','helpdesk','technician','workflow','utilities','agent','ai','ad','exchange','windows','security','performance','monitoring' # A URL to the license for this module. LicenseUri = 'https://opensource.org/licenses/MIT' # A URL to the main website for this project. ProjectUri = 'https://github.com/dan-damit/TechToolbox' # A URL to an icon representing this module. # IconUri = '' # ReleaseNotes of this module ReleaseNotes = ' ## Orchestrator Upgrades - Condensed Release Notes ### Summary - Reworked orchestration into an explicit, typed state machine with deterministic transitions and centralized state reduction. - Added bounded cancellation, deadlines, execution budgets, structured retry semantics, and per-tool time limits. - Centralized tool policy and authorization with fail-closed mutation and path-safety checks. - Hardened decision validation, repair handling, and no-progress loop detection. - Improved weather and NOAA routing with provenance-aware ZIP candidate scoring and clarification fallbacks. - Added structured, redacted, and resource-bounded telemetry with memory privacy safeguards and final integration coverage. ### Phase Highlights - Phase 01 - State model and decision pipeline - Split orchestration into explicit planning, validation, policy, authorization, execution, reduction, and continuation stages. - Defined typed outcomes for continue, retry, finalize, clarification, failure, and block. - Added transition, ordering, invariant, and side-effect regression coverage. - Phase 02 - Cancellation, budgets, and retries - Propagated CancellationToken through model and tool execution. - Added run-wide limits for time, iterations, tools, and output. - Replaced heuristic retries with structured failure codes and retryability metadata. - Added timeout, deadline, cancellation, and retry-exhaustion tests. - Phase 03 - Tool policy and authorization - Introduced a centralized ToolPolicy registry covering schemas, safety, mutation type, paths, and output constraints. - Enforced resolve -> validate -> authorize -> execute -> normalize ordering. - Added structured tool results, redacted diagnostics, postcondition checks, and fail-closed mutation tests. - Phase 04 - Validation, repair, and loop progress - Added versioned decision schemas and field-level validation errors. - Added bounded repair attempts and revalidated repair output before execution. - Added recent-history progress signatures distinguishing repeated calls, targets, and evidence. - Added malformed-decision, repair-budget, and no-progress loop coverage. - Phase 05 - Weather and routing hardening - Added provenance-aware ZIP candidate extraction and scoring. - Rejects unrelated or low-confidence five-digit values from noisy search results. - Requires confidence and winner-margin thresholds before NOAA requests. - Falls back to clarification or blocking when location evidence is insufficient. - Phase 06 - Telemetry, privacy, and integration - Adds structured run, attempt, iteration, tool, policy, retry, cancellation, and result-size telemetry. - Redacts secrets, tokens, authorization headers, and sensitive path data. - Bounds retention by data class and prevents memory preferences from overriding explicit user constraints. - Adds integration coverage for prompt injection, memory leakage, loop control, safety, determinism, and concurrent runs. ### Cross-Phase Contracts - Versioned contracts for run state, decisions, tool results, telemetry, and memory records. - Central ownership matrix for state, validation, repair, authorization, retries, execution, finalization, redaction, and memory precedence. - Explicit precedence rules for policy, execution semantics, user intent, memory, repair output, and deadlines. - Numeric ceilings for runtime, iterations, tool/model calls, repair attempts, loop history, output size, and telemetry retention. - Compatibility and fail-closed behavior for unknown contract versions. ### Validation Baseline - Release build of the agent project. - Focused release tests covering orchestration, execution, tools, safety, retries, loops, policy, authorization, telemetry, and weather routing. - End-to-end scenarios for normal execution, blocked mutations, cancellation, retry exhaustion, no-progress loops, low-confidence locations, prompt injection, and concurrent runs.' # Prerelease string of this module # Prerelease = '' # Flag to indicate whether the module requires explicit user acceptance for install/update/save # RequireLicenseAcceptance = $false # External dependent modules of this module # ExternalModuleDependencies = @() } # End of PSData hashtable } # End of PrivateData hashtable # HelpInfo URI of this module HelpInfoURI = 'https://dan-damit.github.io/TechToolbox-Docs/' # Default prefix for commands exported from this module. Override the default prefix using Import-Module -Prefix. # DefaultCommandPrefix = '' } |