ChatGPS.psd1

#
# Module manifest for module 'ChatGPS'
#
# Generated by: Adam Edwards (adamedx)
#
# Generated on: 11/24/2023
#

@{

# Script module or binary module file associated with this manifest.
RootModule = 'src/ChatGPS.psm1'

# Version number of this module.
ModuleVersion = '0.3.0'

# Supported PSEditions
# CompatiblePSEditions = @()

# ID used to uniquely identify this module
GUID = '9333772d-94da-46a1-a959-32d3085c8e12'

# Author of this module
Author = 'Adam Edwards (adamedx)'

# Company or vendor of this module
CompanyName = 'Modulus Group'

# Copyright statement for this module
Copyright = '(c) Adam Edwards.'

# Description of the functionality provided by this module
Description = 'Access language models in your scripts and terminal, build AI agents with PowerShell.'

# Minimum version of the PowerShell engine required by this module
PowerShellVersion = '7.4.0'

# 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 = @('lib/BaseTypes.dll', 'lib/ChatGPSLib.dll')

# Script files (.ps1) that are run in the caller's environment prior to importing this module.
ScriptsToProcess = @('src/init/ModuleParentEnvironment.ps1')

# Type files (.ps1xml) to be loaded when importing this module
# TypesToProcess = @()

# Format files (.ps1xml) to be loaded when importing this module
FormatsToProcess = @('src/format/format.ps1xml')

# 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 = @(
    'Add-ChatPlugin'
    'Add-ChatPluginFunction'
    'Build-ChatCode'
    'Clear-ChatAgentState'
    'Clear-ChatConversation'
    'Clear-ChatLog'
    'Connect-ChatSession'
    'Get-ChatConversation'
    'Get-ChatCurrentVoice'
    'Get-ChatEncryptedUnicodeKeyCredential'
    'Get-ChatFunction'
    'Get-ChatLog'
    'Get-ChatPlugin'
    'Get-ChatSession'
    'Get-ChatSettingsInfo'
    'Get-ChatVoiceName'
    'Install-ChatAddOn'
    'Invoke-ChatFunction'
    'New-ChatFunction'
    'New-ChatVoice'
    'New-ChatScriptBlock'
    'New-ChatSettings'
    'Out-ChatVoice'
    'Register-ChatPlugin'
    'Remove-ChatFunction'
    'Remove-ChatPlugin'
    'Remove-ChatSession'
    'Save-ChatSessionSetting'
    'Select-ChatSession'
    'Send-ChatMessage'
    'Set-ChatAgentAccess'
    'Set-ChatCurrentVoice'
    'Start-ChatAgent'
    'Start-ChatShell'
    'Stop-ChatAgent'
    'Unregister-ChatPlugin'
    'Update-ChatSettings'
)

# 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 = @(
    'chatgps'
    'Clear-ChatHistory'
    'frun'
    'Generate-ChatCode'
    'Get-ChatHistory'
    'gss'
    'ncs'
    'sch'
    'scs'
    'Start-ChatRepl'
)

# 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 = @(
    'ChatGPS.psd1'
    'lib/ChatGPSLib.dll'
    'src/addons.ps1'
    'src/aliases.ps1'
    'src/ChatGPS.psm1'
    'src/ChatGPS.ps1'
    'src/addons/addons.ps1'
    'src/addons/OnnxChatClientFactory.ps1'
    'src/addons/Tools.ps1'
    'src/codegen.ps1'
    'src/codegen/CodeGeneration.ps1'
    'src/codegen/LanguageBinding.ps1'
    'src/codegen/PowerShellCodeGen.ps1'
    'src/commands.ps1'
    'src/commands/Add-ChatPlugin.ps1'
    'src/commands/Add-ChatPluginFunction.ps1'
    'src/commands/Build-ChatCode.ps1'
    'src/commands/Clear-ChatAgentState.ps1'
    'src/commands/Clear-ChatConversation.ps1'
    'src/commands/Clear-ChatLog.ps1'
    'src/commands/Connect-ChatSession.ps1'
    'src/commands/Get-ChatConversation.ps1'
    'src/commands/Get-ChatCurrentVoice.ps1'
    'src/commands/Get-ChatEncryptedUnicodeKeyCredential.ps1'
    'src/commands/Get-ChatFunction.ps1'
    'src/commands/Get-ChatLog.ps1'
    'src/commands/Get-ChatPlugin.ps1'
    'src/commands/Get-ChatSession.ps1'
    'src/commands/Get-ChatSettingsInfo.ps1'
    'src/commands/Get-ChatVoiceName.ps1'
    'src/commands/Install-ChatAddOn.ps1'
    'src/commands/Invoke-ChatFunction.ps1'
    'src/commands/New-ChatFunction.ps1'
    'src/commands/New-ChatScriptBlock.ps1'
    'src/commands/New-ChatSettings.ps1'
    'src/commands/New-ChatVoice.ps1'
    'src/commands/Out-ChatVoice.ps1'
    'src/commands/Register-ChatPlugin.ps1'
    'src/commands/Remove-ChatFunction.ps1'
    'src/commands/Remove-ChatPlugin.ps1'
    'src/commands/Remove-ChatSession.ps1'
    'src/commands/Save-ChatSessionSetting.ps1'
    'src/commands/Select-ChatSession.ps1'
    'src/commands/Send-ChatMessage.ps1'
    'src/commands/Set-ChatAgentAccess.ps1'
    'src/commands/Set-ChatCurrentVoice.ps1'
    'src/commands/Start-ChatAgent.ps1'
    'src/commands/Start-ChatShell.ps1'
    'src/commands/Stop-ChatAgent.ps1'
    'src/commands/Unregister-ChatPlugin.ps1'
    'src/commands/Update-ChatSettings.ps1'
    'src/config.ps1'
    'src/config/Settings.ps1'
    'src/format/colorstring.ps1'
    'src/format/format.ps1xml'
    'src/function.ps1'
    'src/function/Function.ps1'
    'src/init/ModuleParentEnvironment.ps1'
    'src/intent.ps1'
    'src/intent/PromptBook.ps1'
    'src/native.ps1'
    'src/plugins.ps1'
    'src/plugins/GeneratePlugin.ps1'
    'src/plugins/PluginParameter.ps1'
    'src/plugins/PluginParameterCompleter.ps1'
    'src/plugins/PluginUtilities.ps1'
    'src/presentation.ps1'
    'src/presentation/model.ps1'
    'src/presentation/reply.ps1'
    'src/presentation/voice.ps1'
    'src/services.ps1'
    'src/services/session.ps1'
    'src/shell.ps1'
    'src/shell/replcommand.ps1'
    'src/shell/ReplState.ps1'
    'src/shell/ShellAgent.ps1'
    'src/shell/shellux.ps1'
)

# 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 = @{

    PSData = @{

        # Tags applied to this module. These help with module discovery in online galleries.
        Tags = @('DevOps', 'AI', 'LLM', 'GPT', 'Azure', 'OpenAI', 'Onnx', 'Phi', 'Ollama', 'Gemini', 'Anthropic', 'Claude')

        # A URL to the license for this module.
        LicenseUri = 'http://www.apache.org/licenses/LICENSE-2.0'

        # A URL to the main website for this project.
        ProjectUri = 'https://github.com/adamedx/ChatGPS'

        # A URL to an icon representing this module.
        IconUri = 'https://raw.githubusercontent.com/adamedx/ChatGPS/main/ChatGPS/assets/ChatGPS.png'

        # Prerelease string of this module
        # Prerelease = 'preview'

        # Flag to indicate whether the module requires explicit user acceptance for install/update/save
        RequireLicenseAcceptance = $false

        # External dependent modules of this module
        # ExternalModuleDependencies = @()

        # ReleaseNotes of this module
        ReleaseNotes = @'
## ChatGPS 0.3.0 Release Notes
 
Complete port from Semantic Kernel to Microsoft Agent Framework, many breaking changes, most related to the port, other changes
caused by removal of confusing interfaces.
 
### New dependencies
 
* Microsoft Agent Framework is the new model / agent SDK dependency
  * Semantic Kernel has been completed removed
* Update to Anthropic.SDK 5.10.0
 
### Breaking changes
 
* The DeploymentName parameter is removed. ModelIdentifier should be used in place of DeploymentName
  * This change may also break existing settings that do not specify ModelIdentifier for the correct model
* AllowInteractiveSignin is removed -- it was not actually implemented correctly
* The Bing plugin is removed -- Bing no longer supports the search API; any AI integration must go through Azure Foundry models
  * This may also break settings if the Bing plugin is configured for a session in settings.
* The ConversationSummary plugin is removed as it did not seem necessary for most use cases
 
### New features
 
* Connect-ChatSession has new parameters -- these are also configurable as settings in settings.json:
  * LocalModelProvider: Useful currently for local Onnx models -- lets you specify a model-specific "provider" of inferencing.
    For example, Phi models will default to using CPU for inferencing, but if you specify this parameter as "dml" for DirectML,
    then Onnx will attempt to use DirectML for much faster inferencing if your hardware supports it.
  * LocalModelProviderOptions: Its use depends on your hardware and the Onnx model you're using, but this optional parameter may
    allow you to specify additional parameters to the Onnx SDK depending on yuor model to configure inferencing.
  * NoAuthentication: Useful when you are accessing models hosted on your local computer or LAN that do not require authentication;
    otherwise you will be required to specify a "fake" API key
  * TenantId: Specify this parameter when authenticating to models that use an identity provider like Entra ID -- currently
    this only applies to Azure OpenAI-based models. When using Entra ID, you may be signed in to more than one account or tenant
    the device, so specify the TenantId parameter with the correct tenant you are signing in to in order to disambiguate and
    avoid difficult-to-diagnose cases where you think you're authenticating as one user but the system is using one of the other
    identities cached on your system.
* Brave Search plugin: Allows you to use the Brave Search API if you have an API key for that service; ostensibly replaces the
  returned Bing plugin
* The AIProxy process that interacts with models now stays around longer for models with a local path since that process has
  typically loaded the model into memory; keeping it around longer means additional requests can use that proxy without having to
  start a new one with the slow process of reloading the model, which can take noticeable time (from a several seconds to a minute)
  on each subsequent chat you send. Remote model or http-based proxy lifetimes are unaffected and still terminate shortly (< 2 minutes) of idle time
* Shell Agent: A new shell agent capability is added through the Start-ChatAgent command. When this is invoked for a given session, language model interactions through Send-ChatMessage and Start-ChatShell will have access to your command history as well as terminal output to standard output, allowing the language model to "see" all activity in your terminal. New commands include:
  * Start-ChatAgent -- enables the agent for a session
  * Stop-ChatAgent -- disables the agent for a session
  * Clear-ChatAgentState -- deletes leftover transcript files from Start-Transscript used by the agent to obtain a log of terminal activity.
 
* Code generation improvements: Build-ChatCode provides runtime language integration when generating code for languages other than PowerShell; this allows you to invoke the generated code from PowerShell itself. Build-ChatCode now supports a 'runblock," which is a script block that wraps generated code so that it can be executed by a runtime appropriate to that code. This optional feature allows you to instruct Build-ChatCode to add a wrapper around the generated code that invokes it so that the output of Build-ChatCode can be executed from PowerShell. This isn't needed of course when generating PowerShell code, but since PowerShell can't execute Python code without a Python interpreter, a Runblock wrapper can be used so that the result of Build-ChatCode is itself a PowerShell script block that passes the generated code to the appropriate language runtime to execute it. Build-ChatCode can automatically generated wrappers for Python and Javascript, and you can also specify a custom RunBlock for other langauges.
 
### Fixed defects
 
* Function / Tool calling fixed for Anthropic provider: previously tool calling failed for Anthropic models, but with an update
  to a newer SDK tool calling is now fixed and works just as with other providers.
* Some properties of sessions that weren't displayed for commands piped to Format-Table such as Get-ChatSession now show up,
  including PlainTextApiKey
* Race conditions on the lifetime of the AIProxy could cause some long-running requests to models to fail because the model
  tried to terminate in the middle of request processing -- this has been fixed.
 
'@


    } # End of PSData hashtable

} # End of PrivateData hashtable

# HelpInfo URI of this module
# HelpInfoURI = ''

# Default prefix for commands exported from this module. Override the default prefix using Import-Module -Prefix.
# DefaultCommandPrefix = ''

}