nano-bots 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0fc904784fe79cd5bd873dc3861dd82412f037012ca125011ab795e5cb01e2b1
-  data.tar.gz: 76f64af2d36b5b2765d98f90281577a88e0fcb166143d859829e1b8607fe9e57
+  metadata.gz: c992bede26be258d71c430d42cde2bf369f0ca90b3b835998829008612c7e1aa
+  data.tar.gz: 122564e6d76bab01b3f18e825c75209ca4a6c531957a5f7ed94e8921e40a3d3a
 SHA512:
-  metadata.gz: 3889cdb807954fb4b09add6e53d9ed314457b1d4c0f7e6b1969a0d421f10062b69d76505aa67eba0ee0f5de91e3fd44c7e4934606537ff688897ca0d13007156
-  data.tar.gz: f280c854038822d48ede7bdd1076256d1f8d535c5cc336948921cd1843e34f9a5fb4d207035ac1196efb7e72bc8fecd3d7be57b66b98fc7da94f5b3f7536430e
+  metadata.gz: 55e3ee927659469db0c0533c55241e752ebee17869fe290f9f242de28e3503f74ba7e5c69530d886ce8614b7c68e079c1bf912264c717cb61061e3bfc445e63e
+  data.tar.gz: 8e990faf709f6c720f9ba8f9aab59196e729416f762968f6a02badfe7879b9f24de5ff833b102e99d6aed53a694710f6712b1995e336403c40203dbbff621e1b

data/Gemfile

@@ -7,6 +7,6 @@ gemspec
 group :test, :development do
   gem 'pry-byebug', '~> 3.10', '>= 3.10.1'
   gem 'rspec', '~> 3.12'
-  gem 'rubocop', '~> 1.57', '>= 1.57.2'
+  gem 'rubocop', '~> 1.58'
   gem 'rubocop-rspec', '~> 2.25'
 end

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    nano-bots (1.0.0)
+    nano-bots (1.0.1)
       babosa (~> 2.0)
       concurrent-ruby (~> 1.2, >= 1.2.2)
       dotenv (~> 2.8, >= 2.8.1)
@@ -32,7 +32,7 @@ GEM
       multipart-post (~> 2)
     faraday-net_http (3.0.2)
     ffi (1.16.3)
-    json (2.6.3)
+    json (2.7.0)
     language_server-protocol (3.17.0.3)
     method_source (1.0.0)
     multipart-post (2.3.0)
@@ -65,7 +65,7 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.12.0)
     rspec-support (3.12.1)
-    rubocop (1.57.2)
+    rubocop (1.58.0)
       json (~> 2.3)
       language_server-protocol (>= 3.17.0)
       parallel (~> 1.10)
@@ -73,7 +73,7 @@ GEM
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 1.8, < 3.0)
       rexml (>= 3.2.5, < 4.0)
-      rubocop-ast (>= 1.28.1, < 2.0)
+      rubocop-ast (>= 1.30.0, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 3.0)
     rubocop-ast (1.30.0)
@@ -103,7 +103,7 @@ DEPENDENCIES
   nano-bots!
   pry-byebug (~> 3.10, >= 3.10.1)
   rspec (~> 3.12)
-  rubocop (~> 1.57, >= 1.57.2)
+  rubocop (~> 1.58)
   rubocop-rspec (~> 2.25)
 
 BUNDLED WITH

data/README.md

@@ -13,6 +13,8 @@ https://user-images.githubusercontent.com/113217272/238141567-c58a240c-7b67-4b3b
   - [Command Line](#command-line)
   - [Library](#library)
 - [Cartridges](#cartridges)
+  - [Tools (Functions)](#tools-functions)
+    - [Experimental Clojure Support](#experimental-clojure-support)
   - [Marketplace](#marketplace)
 - [Security and Privacy](#security-and-privacy)
   - [Cryptography](#cryptography)
@@ -28,13 +30,13 @@ https://user-images.githubusercontent.com/113217272/238141567-c58a240c-7b67-4b3b
 For a system usage:
 
 ```sh
-gem install nano-bots -v 1.0.0
+gem install nano-bots -v 1.0.1
 ```
 
 To use it in a project, add it to your `Gemfile`:
 
 ```ruby
-gem 'nano-bots', '~> 1.0.0'
+gem 'nano-bots', '~> 1.0.1'
 ```
 
 ```sh
@@ -80,12 +82,11 @@ cp docker-compose.example.yml docker-compose.yml
 Set your provider credentials and choose your desired directory for the cartridges files:
 
 ```yaml
-version: '3.7'
-
+---
 services:
   nano-bots:
-    image: ruby:3.2.2-slim-bullseye
-    command: sh -c "gem install nano-bots -v 1.0.0 && bash"
+    image: ruby:3.2.2-slim-bookworm
+    command: sh -c "apt-get update && apt-get install -y --no-install-recommends build-essential libffi-dev libsodium-dev lua5.4-dev curl && curl -s https://raw.githubusercontent.com/babashka/babashka/master/install | bash && gem install nano-bots -v 1.0.1 && bash"
     environment:
       OPENAI_API_ADDRESS: https://api.openai.com
       OPENAI_API_KEY: your-access-token
@@ -249,7 +250,7 @@ meta:
   symbol: 🤖
   name: Nano Bot Name
   author: Your Name
-  version: 1.0.0
+  version: 1.0.1
   license: CC0-1.0
   description: A helpful assistant.
 
@@ -271,6 +272,85 @@ Check the Nano Bots specification to learn more about [how to build cartridges](
 
 Try the [Nano Bots Clinic (Live Editor)](https://clinic.nbots.io) to learn about creating Cartridges.
 
+### Tools (Functions)
+
+Nano Bots can also be powered by _Tools_ (Functions):
+
+```yaml
+---
+tools:
+  - name: random-number
+    description: Generates a random number between 1 and 100.
+    fennel: |
+      (math.random 1 100)
+```
+
+```
+🤖> please generate a random number
+
+random-number {} [yN] y
+
+random-number {}
+59
+
+The randomly generated number is 59.
+
+🤖> |
+```
+
+To successfully use Tools (Functions), you need to specify a provider and a model that support them. As of the writing of this README, the provider that supports them is [OpenAI](https://platform.openai.com/docs/models), with models `gpt-3.5-turbo-1106` and `gpt-4-1106-preview`:
+
+```yaml
+---
+provider:
+  id: openai
+  credentials:
+    address: ENV/OPENAI_API_ADDRESS
+    access-token: ENV/OPENAI_API_KEY
+  settings:
+    user: ENV/NANO_BOTS_END_USER
+    model: gpt-4-1106-preview
+```
+
+Check the [Nano Bots specification](https://spec.nbots.io/#/README?id=tools-functions-2) to learn more about them.
+
+#### Experimental Clojure Support
+
+We are exploring the use of [Clojure](https://clojure.org) through [Babashka](https://babashka.org), powered by [GraalVM](https://www.graalvm.org).
+
+The experimental support for Clojure would be similar to Lua and Fennel, using the `clojure:` key:
+
+```yaml
+---
+clojure: |
+  (-> (java.time.ZonedDateTime/now)
+      (.format (java.time.format.DateTimeFormatter/ofPattern "yyyy-MM-dd HH:mm"))
+      (clojure.string/trimr))
+```
+
+Unlike Lua and Fennel, Clojure support is not _embedded_ in this implementation. It relies on having the Babashka binary (`bb`) available in your environment where the Nano Bot is running.
+
+Here's [how to install Babashka](https://github.com/babashka/babashka#quickstart):
+
+```sh
+curl -s https://raw.githubusercontent.com/babashka/babashka/master/install | bash
+```
+
+This is a quick check to ensure that it is available and working:
+```sh
+bb -e '{:hello "world"}'
+# => {:hello "world"}
+```
+
+We don't have sandbox support for Clojure; this means that you need to disable it to be able to run Clojure code, which you do at your own risk:
+
+```yaml
+---
+safety:
+  functions:
+    sandboxed: false
+```
+
 ### Marketplace
 
 You can explore the Nano Bots [Marketplace](https://nbots.io) to discover new Cartridges that can help you.
@@ -408,5 +488,5 @@ gem build nano-bots.gemspec
 
 gem signin
 
-gem push nano-bots-1.0.0.gem
+gem push nano-bots-1.0.1.gem
 ```

data/controllers/security.rb

@@ -18,11 +18,10 @@ module NanoBot
         password = 'UNSAFE' unless password && password != ''
 
         {
-          encryption: (
+          encryption:
             Components::Crypto.encrypt('SAFE') != 'SAFE' &&
-            Components::Crypto.encrypt('SAFE') != Components::Crypto.encrypt('SAFE') &&
-            Components::Crypto.decrypt(Components::Crypto.encrypt('SAFE')) == 'SAFE'
-          ),
+              Components::Crypto.encrypt('SAFE') != Components::Crypto.encrypt('SAFE') &&
+              Components::Crypto.decrypt(Components::Crypto.encrypt('SAFE')) == 'SAFE',
           password: password != 'UNSAFE'
         }
       end

data/docker-compose.example.yml

@@ -1,9 +1,8 @@
-version: '3.7'
-
+---
 services:
   nano-bots:
-    image: ruby:3.2.2-slim-bullseye
-    command: sh -c "apt-get update && apt-get install -y --no-install-recommends build-essential libffi-dev libsodium-dev lua5.4-dev && gem install nano-bots -v 1.0.0 && bash"
+    image: ruby:3.2.2-slim-bookworm
+    command: sh -c "apt-get update && apt-get install -y --no-install-recommends build-essential libffi-dev libsodium-dev lua5.4-dev curl && curl -s https://raw.githubusercontent.com/babashka/babashka/master/install | bash && gem install nano-bots -v 1.0.1 && bash"
     environment:
       OPENAI_API_ADDRESS: https://api.openai.com
       OPENAI_API_KEY: your-access-token

data/static/fennel/LICENSE

@@ -1,7 +1,5 @@
 MIT License
 
-Copyright © 2016-2022 Calvin Rose and contributors
-
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
 in the Software without restriction, including without limitation the rights