From 81c4b1f927dec844dd6b06411d71c1ece3923351 Mon Sep 17 00:00:00 2001
From: jurij-jukic <j.jjukicc@gmail.com>
Date: Wed, 8 May 2024 13:14:15 +0200
Subject: [PATCH 1/6] add link

---
 src/terminal.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/terminal.md b/src/terminal.md
index b8dbae92..9b11931f 100644
--- a/src/terminal.md
+++ b/src/terminal.md
@@ -2,7 +2,7 @@
 
 ## Commands
 
-All commands in the terminal are calling scripts - a special kind of process.
+All commands in the [terminal](https://github.com/kinode-dao/kinode/tree/main/kinode/packages/terminal) are calling scripts - a special kind of process.
 Kinode OS comes pre-loaded with a number of scripts useful for debugging and everyday use.
 These scripts are fully named `<SCRIPT>:terminal:sys` e.g `hi:terminal:sys`, but the distro [aliases](#alias---alias-a-script-name) these to short names, in this case just `hi`, for convenience.
 

From 7106135dc9401443bd92f1a3debaba1eb42a6e2c Mon Sep 17 00:00:00 2001
From: jurij-jukic <j.jjukicc@gmail.com>
Date: Wed, 8 May 2024 13:37:14 +0200
Subject: [PATCH 2/6] module -> WASM module

---
 src/terminal.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/terminal.md b/src/terminal.md
index 9b11931f..000a96ea 100644
--- a/src/terminal.md
+++ b/src/terminal.md
@@ -83,16 +83,16 @@ For your scripts to be usable by the terminal, you must include a `pkg/scripts.j
 The JSON object in `scripts.json` describes the configuration for each script in your package.
 Each top-level key represents the path of the WASM module in your package, usually just `"myscript.wasm"`, `"echo.wasm"`, etc.
 
-The value for each module is an object that specifies the configuration for that particular module.
+Within this JSON object, for each key (WASM module) the value is an object that specifies the configuration for that particular module.
 The object can contain the following fields:
 
 - `root` (Boolean): Indicates whether the script has "root" privileges - meaning whether it gets *every* capability that the terminal has (not necessarily every capability in existence on your machine)
 - `public` (Boolean): Determines if the script is publicly accessible by other processes
 - `requestNetworking` (Boolean): Specifies whether the script will get networking capabilities
 - `requestCapabilities` (Array): An array that lists the capabilities requested by the script. Each element in the array can be either a string or an object. The string represents a `ProcessId` that this script will be able to message. When an object is used, it specifies a different kind of capability from `issuer` with `params` as an arbitrary json object.
-- `grantCapabilities` (Array): An array `ProcessId`s as strings which represent which processes will be able to message this script back
+- `grantCapabilities` (Array): An array of `ProcessId`s as strings which represent which processes will be able to message this script back
 
-Modules may not necessarily use all these fields. For instance, "m.wasm" only uses root, public, and requestNetworking, omitting requestCapabilities and grantCapabilities.
+WASM modules may not necessarily use all these fields. For instance, "m.wasm" only uses root, public, and requestNetworking, omitting requestCapabilities and grantCapabilities.
 
 ### Example
 This is a `scripts.json` that publishes a single script, `hi`, which doesn't receive `root` capabilities, is not `public`, can send messages over the network, will receive the capability to message `net:distro:sys`, and gives `net:distro:sys` the ability to message it back:

From 153670260975dc6197941c14c6ed5b334b82c2e6 Mon Sep 17 00:00:00 2001
From: jurij-jukic <j.jjukicc@gmail.com>
Date: Thu, 9 May 2024 09:13:34 +0200
Subject: [PATCH 3/6] apply requested changes

---
 src/terminal.md | 25 +++++++++++++++----------
 1 file changed, 15 insertions(+), 10 deletions(-)

diff --git a/src/terminal.md b/src/terminal.md
index 000a96ea..38ed7fce 100644
--- a/src/terminal.md
+++ b/src/terminal.md
@@ -79,20 +79,25 @@ Example:
 For more information on writing your own scripts, see the [cookbook](./cookbook/writing_scripts.md).
 
 ## Packaging Scripts with `scripts.json`
-For your scripts to be usable by the terminal, you must include a `pkg/scripts.json` file.
+For your scripts to be usable by the terminal, you must include a `pkg/scripts.json` file, like [this one](https://github.com/kinode-dao/kinode/blob/main/kinode/packages/terminal/pkg/scripts.json).
+Note that this is a core package and this file should not be edited, but rather you should create one in your own package.
+For more discussion on package folder structure, look [here](https://book.kinode.org/my_first_app/chapter_1.html#exploring-the-package).
+
 The JSON object in `scripts.json` describes the configuration for each script in your package.
-Each top-level key represents the path of the WASM module in your package, usually just `"myscript.wasm"`, `"echo.wasm"`, etc.
+Each top-level key represents the path of a process in your package, usually just `"myscript.wasm"`, `"echo.wasm"`, etc.
 
-Within this JSON object, for each key (WASM module) the value is an object that specifies the configuration for that particular module.
+Within this JSON object, for each key (i.e., process) the value is an object that specifies the configuration for that particular process.
 The object can contain the following fields:
 
 - `root` (Boolean): Indicates whether the script has "root" privileges - meaning whether it gets *every* capability that the terminal has (not necessarily every capability in existence on your machine)
 - `public` (Boolean): Determines if the script is publicly accessible by other processes
-- `requestNetworking` (Boolean): Specifies whether the script will get networking capabilities
-- `requestCapabilities` (Array): An array that lists the capabilities requested by the script. Each element in the array can be either a string or an object. The string represents a `ProcessId` that this script will be able to message. When an object is used, it specifies a different kind of capability from `issuer` with `params` as an arbitrary json object.
-- `grantCapabilities` (Array): An array of `ProcessId`s as strings which represent which processes will be able to message this script back
+- `request_networking` (Boolean): Specifies whether the script will get networking capabilities
+- `request_capabilities` (Array): An array that lists the capabilities requested by the script. Each element in the array can be either a string or an object.
+The string represents a `ProcessId` that this script will be able to message. When an object is used, it specifies a different kind of capability from `issuer` with `params` as an arbitrary json object.
+- `grant_capabilities` (Array): An array of `ProcessId`s as strings which represent which processes will be able to message this script back
 
-WASM modules may not necessarily use all these fields. For instance, "m.wasm" only uses root, public, and requestNetworking, omitting requestCapabilities and grantCapabilities.
+Processes may not necessarily use all these fields.
+For instance, "m.wasm" only uses root, public, and requestNetworking, omitting requestCapabilities and grantCapabilities.
 
 ### Example
 This is a `scripts.json` that publishes a single script, `hi`, which doesn't receive `root` capabilities, is not `public`, can send messages over the network, will receive the capability to message `net:distro:sys`, and gives `net:distro:sys` the ability to message it back:
@@ -101,11 +106,11 @@ This is a `scripts.json` that publishes a single script, `hi`, which doesn't rec
     "hi.wasm": {
         "root": false,
         "public": false,
-        "requestNetworking": true,
-        "requestCapabilities": [
+        "request_networking": true,
+        "request_capabilities": [
             "net:distro:sys"
         ],
-        "grantCapabilities": [
+        "grant_capabilities": [
             "net:distro:sys"
         ]
     }

From 714f80435e9abe0376c70dabe761f1da944e222a Mon Sep 17 00:00:00 2001
From: jurij-jukic <j.jjukicc@gmail.com>
Date: Fri, 10 May 2024 09:29:53 +0200
Subject: [PATCH 4/6] clarify grant_caps

---
 src/terminal.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/terminal.md b/src/terminal.md
index 38ed7fce..b972bae0 100644
--- a/src/terminal.md
+++ b/src/terminal.md
@@ -94,10 +94,10 @@ The object can contain the following fields:
 - `request_networking` (Boolean): Specifies whether the script will get networking capabilities
 - `request_capabilities` (Array): An array that lists the capabilities requested by the script. Each element in the array can be either a string or an object.
 The string represents a `ProcessId` that this script will be able to message. When an object is used, it specifies a different kind of capability from `issuer` with `params` as an arbitrary json object.
-- `grant_capabilities` (Array): An array of `ProcessId`s as strings which represent which processes will be able to message this script back
+- `grant_capabilities` (Array of strings): An array of `ProcessId`s which represents which processes will be able to send a `Response` back to this script. If this script is public, `grant_capabilities` can stay empty.
 
 Processes may not necessarily use all these fields.
-For instance, "m.wasm" only uses root, public, and requestNetworking, omitting requestCapabilities and grantCapabilities.
+For instance, "m.wasm" only uses root, public, and `request_networking`, omitting `request_capabilities` and `grant_capabilities`.
 
 ### Example
 This is a `scripts.json` that publishes a single script, `hi`, which doesn't receive `root` capabilities, is not `public`, can send messages over the network, will receive the capability to message `net:distro:sys`, and gives `net:distro:sys` the ability to message it back:

From b3909660a3e1e0b9989c76696fbbc0302ed78a92 Mon Sep 17 00:00:00 2001
From: jurij-jukic <j.jjukicc@gmail.com>
Date: Fri, 10 May 2024 10:58:49 +0200
Subject: [PATCH 5/6] add link to terminal syntax

---
 src/terminal.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/terminal.md b/src/terminal.md
index b972bae0..a9ab78a6 100644
--- a/src/terminal.md
+++ b/src/terminal.md
@@ -1,5 +1,7 @@
 # Terminal
 
+The [terminal syntax](https://github.com/kinode-dao/kinode?tab=readme-ov-file#terminal-syntax) is specified in the main Kinode repository.
+
 ## Commands
 
 All commands in the [terminal](https://github.com/kinode-dao/kinode/tree/main/kinode/packages/terminal) are calling scripts - a special kind of process.

From 137645e61e9b5ca9b58eb71d03d355183a5ba1be Mon Sep 17 00:00:00 2001
From: jurij-jukic <j.jjukicc@gmail.com>
Date: Fri, 10 May 2024 18:52:05 +0200
Subject: [PATCH 6/6] fix nits

---
 src/terminal.md | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/src/terminal.md b/src/terminal.md
index a9ab78a6..da713ef7 100644
--- a/src/terminal.md
+++ b/src/terminal.md
@@ -4,7 +4,7 @@ The [terminal syntax](https://github.com/kinode-dao/kinode?tab=readme-ov-file#te
 
 ## Commands
 
-All commands in the [terminal](https://github.com/kinode-dao/kinode/tree/main/kinode/packages/terminal) are calling scripts - a special kind of process.
+All commands in the [terminal](https://github.com/kinode-dao/kinode/tree/main/kinode/packages/terminal) are calling scripts — a special kind of process.
 Kinode OS comes pre-loaded with a number of scripts useful for debugging and everyday use.
 These scripts are fully named `<SCRIPT>:terminal:sys` e.g `hi:terminal:sys`, but the distro [aliases](#alias---alias-a-script-name) these to short names, in this case just `hi`, for convenience.
 
@@ -96,7 +96,8 @@ The object can contain the following fields:
 - `request_networking` (Boolean): Specifies whether the script will get networking capabilities
 - `request_capabilities` (Array): An array that lists the capabilities requested by the script. Each element in the array can be either a string or an object.
 The string represents a `ProcessId` that this script will be able to message. When an object is used, it specifies a different kind of capability from `issuer` with `params` as an arbitrary json object.
-- `grant_capabilities` (Array of strings): An array of `ProcessId`s which represents which processes will be able to send a `Response` back to this script. If this script is public, `grant_capabilities` can stay empty.
+- `grant_capabilities` (Array of strings): An array of `ProcessId`s which represents which processes will be able to send a `Response` back to this script.
+If this script is public, `grant_capabilities` can stay empty.
 
 Processes may not necessarily use all these fields.
 For instance, "m.wasm" only uses root, public, and `request_networking`, omitting `request_capabilities` and `grant_capabilities`.