aia 0.4.2 → 0.4.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 24e36e9066b83229df951d172cfb3fd7185cadb433fd992ab37fede8d45b8ea5
-  data.tar.gz: f7ce893975dfb29dd69d1ec0922f8ea30987f88d1d3dd69f0ca877218c6c54fc
+  metadata.gz: 3e8cad3b88bdc76e72dce9b7fa202923ab655f2da811039bf18df52c5fe714ae
+  data.tar.gz: 57ae0a1dd04c0fbd237ba8daa3210ae273a8db21e0efe5c154ffbe72c9afd0e5
 SHA512:
-  metadata.gz: 0172e7c82b9e346d176df7691e5eb422515e25f4f7ed243cb92cd38419a4e8a18a1df9f5500ac0606c6bb30d48e88662237877aee4667aedf9cd02973a190268
-  data.tar.gz: c826c22f5b1789ffeeca7982860764527350d3b352cb428a4b1cc6ccc63025fa1c4347ed098477d8d6a0f2f63dfe8fc8187eb9570096698487bf69fe6f8903c0
+  metadata.gz: 0cc90b667bd99aae7688231286c58ee3cc7a3ad4a1b4202c531a71113911d24c084f6ccce5d154d57e0059a2a0b3d6d1706f3ee9a5fae5bf229b2604d1982d4d
+  data.tar.gz: 18dafdbfdeb257a2597f53070feebcb05f409f101b06ff17fdbe81cc813ebbf335833a0eace414638e437425ca47298b26655768890737cb065e3b15cfbf405e

data/.semver

@@ -1,6 +1,6 @@
 ---
 :major: 0
 :minor: 4
-:patch: 2
+:patch: 3
 :special: ''
 :metadata: ''

data/CHANGELOG.md

@@ -1,4 +1,8 @@
 ## [Unreleased]
+## [0.4.3] 2023-12-31
+- added --env to process embedded system environment variables and shell commands within a prompt.
+- added --erb to process Embedded RuBy within a prompt because have embedded shell commands will only get you in a trouble.  Having ERB will really get you into trouble.  Remember the simple prompt is usually the best prompt.
+
 ## [0.4.2] 2023-12-31
 - added the --role CLI option to pre-pend a "role" prompt to the front of a primary prompt.
 

data/README.md

@@ -6,8 +6,9 @@ Uses the gem "prompt_manager" to manage the prompts sent to the `mods` command-l
 
 **Most Recent Change**
 
-v0.4.2 = Added a role option to be prepended to a primary prompt.
-v0.4.1 - Added a chat mode.  Prompt directives are now supported.
+v0.4.3 - Added the --env and --erb options.  Prompts can now be dynamic.
+v0.4.2 - Added a --role option to be prepended to a primary prompt.
+v0.4.1 - Added --chat and --speak options.  Prompt directives are now supported.
 
 <!-- Tocer[start]: Auto-generated, don't remove. -->
 
@@ -16,6 +17,8 @@ v0.4.1 - Added a chat mode.  Prompt directives are now supported.
   - [Installation](#installation)
   - [Usage](#usage)
   - [System Environment Variables (envar)](#system-environment-variables-envar)
+    - [System Environment Variables inside of a Prompt](#system-environment-variables-inside-of-a-prompt)
+  - [*E*mbedded *R*u*B*y (ERB)](#embedded-ruby-erb)
   - [Prompt Directives](#prompt-directives)
   - [All About ROLES](#all-about-roles)
     - [Other Ways to Insert Roles into Prompts](#other-ways-to-insert-roles-into-prompts)
@@ -94,6 +97,24 @@ OPTIONS
 
        --dump FORMAT
 
+       -e, --edit
+              Invokes an editor on the prompt file.  You can make changes to the prompt file,
+              save it and the newly saved prompt will be processed by the backend.
+
+       --env  This option tells aia to replace references to system environment variables in
+              the prompt with the value of the envar.  envars are like $HOME and ${HOME} in
+              this example their occurance will be replaced by the value of ENV[‘HOME’].
+              Also the dynamic shell command in the pattern $(shell command) will be executed
+              and its output replaces its pattern.  It does not matter if your shell uses
+              different patters than BASH since the replacement is being done within a Ruby
+              context.
+
+       --erb  If dynamic prompt content using $(...) wasn’t enough here is ERB.  Embedded
+              RUby.  <%= ruby code %> within a prompt will have its ruby code executed and
+              the results of that execution will be inserted into the prompt.  I’m sure we
+              will find a way to truly misuse this capability.  Remember, some say that the
+              simple prompt is the best prompt.
+
        --model NAME
               Name of the LLM model to use - default is gpt-4-1106-preview
 
@@ -253,6 +274,20 @@ See the `@options` hash in the `cli.rb` file for a complete list.  There are som
 
 In addition to these config items for `aia` the optional command line parameters for the backend prompt processing utilities (mods and sgpt) can also be set using envars with the "AIA_" prefix.  For example "export AIA_TOPP=1.0" will set the "--topp 1.0" command line option for the `mods` utility when its used as the backend processor.
 
+### System Environment Variables inside of a Prompt
+
+The cpmmand line option "--env" instructs `aia` to replace any system environment variable references in the prompt text with the value of the system envornment variable.  So patterns like $HOME and ${HOME} in the prompt will be replaced with the value of ENV['HOME'].
+
+As an added bonus, dynamic content can be inserted into the prompt using the pattern $(shell command) where the output of the shell command will replace the $(...) pattern.
+
+That's enough power to get anyone into deep trouble.  Wait there's more coming.  Do you want a full programming language in your prompt?  Feel like running the prompt through ERB before sending it to the backend?  I've been thinking about it.  Should be a simple thing to do. Yes it was.
+
+## *E*mbedded *R*u*B*y (ERB)
+
+The --erb options now submits the prompt text through the ERB parser for execution before environment variable, keyword and dynamic shell replace take place.  With this much dynamic prompt manipulation we should really be able to get into trouble!
+
+If you are not a Rubyist and do not know about ERB see this [webpage](https://ruby-doc.org/stdlib-3.0.0/libdoc/erb/rdoc/ERB.html) for some information about the power of embedded Ruby.
+
 ## Prompt Directives
 
 Downstream processing directives were added to the `prompt_manager` gem at version 0.4.1.  These directives are lines in the prompt text file that begin with "//"

data/lib/aia/cli.rb

@@ -126,6 +126,8 @@ class AIA::Cli
       completion: [nil,       "--completion"],
       #
       edit?:      [false,     "-e --edit"],
+      env?:       [false,     "--env"],
+      erb?:       [false,     "--erb"],
       debug?:     [false,     "-d --debug"],
       verbose?:   [false,     "-v --verbose"],
       version?:   [false,     "--version"],

data/lib/aia/prompt.rb

@@ -1,6 +1,7 @@
 # lib/aia/prompt.rb
 
 require 'reline'
+require 'erb'
 
 class AIA::Prompt
   #
@@ -36,7 +37,11 @@ class AIA::Prompt
       @prompt.text.prepend @role.text
     end
 
-    process_prompt if build
+    if build
+      @prompt.text = render_erb(@prompt.text)   if AIA.config.erb?
+      @prompt.text = replace_env(@prompt.text)  if AIA.config.env?
+      process_prompt 
+    end
   end
 
 
@@ -77,6 +82,25 @@ class AIA::Prompt
   end
 
 
+  # inserts environmant variables and dynamic content into a prompt
+  # replaces patterns like $HOME and ${HOME} with the value of ENV['HOME']
+  # replaces patterns like $(shell command) with the output of the shell command
+  #
+  def replace_env(a_string)
+    a_string.gsub(/\$(\w+|\{\w+\})/) do |match|
+      ENV[match.tr('$', '').tr('{}', '')]
+    end.gsub(/\$\((.*?)\)/) do |match|
+      `#{match[2..-2]}`.chomp
+    end
+  end
+
+
+  # You are just asking for trouble!
+  def render_erb(a_string)
+    ERB.new(a_string).result(binding)
+  end
+
+
   def replace_keywords
     puts
     puts "ID: #{@prompt.id}"

data/man/aia.1

@@ -29,6 +29,15 @@ begin a chat session with the backend after the initial prompt response;  will s
 .TP
 \fB\-\-dump\fR \fIFORMAT\fP
 .TP
+\fB\-e\fR, \fB\-\-edit\fR
+Invokes an editor on the prompt file\.  You can make changes to the prompt file, save it and the newly saved prompt will be processed by the backend\.
+.TP
+\fB\-\-env\fR
+This option tells \fBaia\fR to replace references to system environment variables in the prompt with the value of the envar\.  envars are like \[Do]HOME and \[Do]\[lC]HOME\[rC] in this example their occurance will be replaced by the value of ENV\[lB]\[oq]HOME\[cq]\[rB]\.  Also the dynamic shell command in the pattern \[Do](shell command) will be executed and its output replaces its pattern\.  It does not matter if your shell uses different patters than BASH since the replacement is being done within a Ruby context\.
+.TP
+\fB\-\-erb\fR
+If dynamic prompt content using \[Do](\.\.\.) wasn\[cq]t enough here is ERB\.  Embedded RUby\.  <%\[eq] ruby code %> within a prompt will have its ruby code executed and the results of that execution will be inserted into the prompt\.  I\[cq]m sure we will find a way to truly misuse this capability\.  Remember, some say that the simple prompt is the best prompt\.
+.TP
 \fB\-\-model\fR \fINAME\fP
 Name of the LLM model to use \- default is gpt\-4\-1106\-preview
 .TP

data/man/aia.1.md

@@ -34,6 +34,15 @@ The aia command-line tool is an interface for interacting with an AI model backe
 `--dump` *FORMAT*
 : Dump a Config File in [yaml | toml] to STDOUT - default is nil
 
+`-e`, `--edit`
+: Invokes an editor on the prompt file.  You can make changes to the prompt file, save it and the newly saved prompt will be processed by the backend.
+
+`--env`
+: This option tells `aia` to replace references to system environment variables in the prompt with the value of the envar.  envars are like $HOME and ${HOME} in this example their occurance will be replaced by the value of ENV['HOME'].  Also the dynamic shell command in the pattern $(shell command) will be executed and its output replaces its pattern.  It does not matter if your shell uses different patters than BASH since the replacement is being done within a Ruby context.
+
+`--erb`
+: If dynamic prompt content using $(...) wasn't enough here is ERB.  Embedded RUby.  <%= ruby code %> within a prompt will have its ruby code executed and the results of that execution will be inserted into the prompt.  I'm sure we will find a way to truly misuse this capability.  Remember, some say that the simple prompt is the best prompt.
+
 `--model` *NAME*
 : Name of the LLM model to use - default is gpt-4-1106-preview
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aia
 version: !ruby/object:Gem::Version
-  version: 0.4.2
+  version: 0.4.3
 platform: ruby
 authors:
 - Dewayne VanHoozer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-12-31 00:00:00.000000000 Z
+date: 2024-01-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: hashie