Merge pull request #20 from HumanAssisted/0.3.0

0.3.1 is mostly upgrading libs
see changelog for other changes

Author: Hendler

.gitignore

@@ -2,6 +2,7 @@
 # will have compiled files and executables
 debug/
 target/
+.idea
 
 # Remove Cargo.lock from gitignore if creating an executable, leave it for libraries
 # More information here https://doc.rust-lang.org/cargo/guide/cargo-toml-vs-cargo-lock.html
@@ -16,4 +17,4 @@ Cargo.lock
 grant.md
 scratch.md
 jacs.config.json
-.DS_Store
+.DS_Store

CHANGELOG.md

@@ -1,11 +1,34 @@
-PLANNED
-
+# PLANNED
+- encrypt files at rest
 - refine schema usage
 - more getters and setters for documents recognized by schemas
-- gzip local files
-- update libs based on devin work
-- store files by type (eval, program, node, task, actor, message)
-- WASM option
+- WASM builds
+
+# COMPLETED
+
+
+## 0.3.1
+- upgraded many dependencies using 
+    cargo install cargo-edit
+    cargo upgrade
+    
+## 0.3.0
+- added jacsType - free naming, but required field for end-user naming of file type, with defaults to "document"
+- TODO update jsonschema library
+- updated strum, criterion
+- updated reqwest library
+- fixed bug EmbeddedSchemaResolver not used for custom schemas
+- added load_all() for booting up  
+- WIP move all fileio to object_store 
+- WIP way to mark documents as not active - separate folder, or just reference them from other docs
+- fixed issue with filepaths for agents and keys
+- added jacsType to to jacs document as required
+- added archive old version, to move older versions of docs to different folder
+- added jacsEmbedding to headers, which allow persistance of vector embeddings iwth jacs docs. 
+- default to only loading most recent version of document in load_all
+- fixed bug with naming file on update
+- changes to message schema to always include header
+- add jacsLevel to track general type of document and its mutability
 
 ## 0.2.13
 - save public key to local fs

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "jacs"
-version = "0.2.13"
+version = "0.3.1"
 edition = "2021"
 include = [
     "src/**/*",
@@ -14,6 +14,7 @@ include = [
     "schemas/components/service/v1/service.schema.json",
     "schemas/components/tool/v1/tool.schema.json",
     "schemas/components/contact/v1/contact.schema.json",
+    "schemas/components/component/v1/component.schema.json",
     "schemas/message/v1/message.schema.json",
     "schemas/node/v1/node.schema.json",
     "schemas/program/v1/program.schema.json",
@@ -41,39 +42,46 @@ build = "build.rs"
 
 
 [dependencies]
-base64 = "0.22.0"
-chrono = "0.4.35"
-jsonschema = "0.17.1"
-log = "0.4.21"
-pem = "3.0.3"
-rand = "0.8.5"
-rsa = { version= "0.9.6", features= ["sha2", "pem"]}
+base64 = "0.22.1"
+chrono = "0.4.39"
+jsonschema = { version = "0.29", features = ["resolve-http", "resolve-file"] }
+log = "0.4.25"
+pem = "3.0.4"
+rand = "0.9.0"
+rsa = { version= "0.9.7", features= ["sha2", "pem"]}
 serde = { version = "1.0", features = ["derive"] }
-serde_json = "1.0 "
+serde_json = "1.0"
 signature = "2.2.0"
-url = "2.5.0"
-sha2 = "0.10.6"
-phf = { version = "0.11.1", features = ["macros"] }
-strum = "0.24.1"
-strum_macros = "0.24.3"
-secrecy = "0.8.0"
+url = "2.5.4"
+sha2 = "0.10.8"
+phf = { version = "0.11.3", features = ["macros"] }
+strum = "0.27.0"
+strum_macros = "0.27.0"
+secrecy = "0.10.3"
 aes-gcm = "0.10.3"
-clap = "4.5.4"
-regex = "1.10.4"
-mime_guess = "2.0.4"
-flate2 = "1.0.28"
-encoding_rs = "0.8.34"
+clap = "4.5.29"
+regex = "1.11.1"
+mime_guess = "2.0.5"
+flate2 = "1.0.35"
+encoding_rs = "0.8.35"
 difference = "2.0.0"
 rpassword = "7.3.1"
-validator = "0.18.1"
-uuid = { version = "1.7.0", features = ["v4", "v7", "js"] }
-env_logger = "0.9.0"
+validator = "0.20.0"
+uuid = { version = "1.13.1", features = ["v4", "v7", "js"] }
+env_logger = "0.11.6"
+futures-util = "0.3.31"
+referencing = "0.29.0"
+# [target.'cfg(target_os = "macos")'.dependencies]
+# pqcrypto-mldsa = { version = "0.1", default-features = false, features = ["serialization"] }
+
+# [target.'cfg(not(target_os = "macos"))'.dependencies]
+# pqcrypto-mldsa = { version = "0.1", features = ["serialization"] }
+
 
 [dev-dependencies]
-rusqlite = "0.31.0"
 color-eyre = "0.6"
-criterion = "0.3"
-mdbook = "0.4.37"
+criterion = "0.5.1"
+mdbook = "0.4.44"
 
 
 [lib]
@@ -83,9 +91,13 @@ crate-type = ["cdylib", "rlib"]
 pqcrypto = "0.17.0"
 pqcrypto-dilithium = {version = "0.5.0", features=["serialization"] }
 pqcrypto-traits = "0.3.5"
-ring = "0.17.8"
-reqwest = {  version ="0.11.26", features = ["blocking", "json"] }
+ring = "0.17.9"
+reqwest = {  version ="0.12.12", features = ["blocking", "json"] }
 walkdir = "2.5.0"
+object_store = { version ="0.11.2", features = ["serde","serde_json", "aws", "http"] }
+
+ [target.'cfg(target_arch = "wasm32")'.dependencies]
+ wasm-bindgen = "0.2.100"
 
 [[bin]]
 name = "jacs"

README.md

@@ -1,10 +1,10 @@
-# JACS
+# JACS 
 
-Welcome to JACS, a source of truth document.
+Welcome to JACS (JSON Agent Communication Standard), a verifiable document format for AI agents.
 
-JACS is JSON Agent Communication Standard. JACS documents enable more trusted data sharing between AI agents and Human UIs.
+JACS documents enable more trusted data sharing between AI agents and Human UIs.
 
-** NOTE: Current version 0.2.12 *ALPHA* .
+** NOTE: Current version 0.3.0 *ALPHA* .
 
 JACS is a JSON document format for creating secure, verifiable documents that AI agents, ML pipelines, SaaS services, and UIs can exchange and process. The goal of JACS is to ensure that these documents remain unchanged (immutable), produce the same verification result every time (idempotent), and can be used flexibly by software.
 
@@ -22,12 +22,14 @@ Use JACS as is, embed in other projects or libraries, commercial or otherwise.
   4. create agreements between human and ai agents
   5. create agents and describe what they can do
   6. create tasks manage their state
+  7. Use with [OpenAI structured ouput](https://openai.com/index/introducing-structured-outputs-in-the-api/)
+
 
 ## Documentation
 
  - [Usage Docs](https://humanassisted.github.io/JACS/)
  - [API docs](https://docs.rs/jacs/latest/jacs/)
- - [pypy]( )
+ - [pypy]( #)
  - [Rust Crate](https://crates.io/crates/jacs)
  - [Schema docs](./schemas)
  - [example files](./examples)
@@ -65,6 +67,9 @@ If you are working in Rust, add the rust lib to your project
 
     cargo add jacs
 
+For development you may want    `cargo install cargo-outdated` and `cargo install cargo-edit`
+
+
 Then start reading the [usage docs](https://humanassisted.github.io/JACS/)
 
 ------

benches/sign_and_check_sig.rs

@@ -1,6 +1,6 @@
 use criterion::{black_box, criterion_group, criterion_main, Criterion};
 use jacs::agent::boilerplate::BoilerPlate;
-use jacs::agent::document::Document;
+use jacs::agent::document::DocumentTraits;
 use jacs::agent::loaders::FileLoader;
 use jacs::agent::Agent;
 use log::debug;

docs/jacsbook/book/404.html

@@ -89,7 +89,7 @@
 
         <nav id="sidebar" class="sidebar" aria-label="Table of contents">
             <div class="sidebar-scrollbox">
-                <ol class="chapter"><li class="chapter-item expanded affix "><a href="index.html">Introduction</a></li><li class="chapter-item expanded affix "><li class="part-title">User Guide</li><li class="chapter-item expanded "><a href="cli/installation.html"><strong aria-hidden="true">1.</strong> Installation</a></li><li class="chapter-item expanded "><a href="cli/agent.html"><strong aria-hidden="true">2.</strong> Creating an Agent</a></li><li class="chapter-item expanded "><a href="cli/documents.html"><strong aria-hidden="true">3.</strong> Working with documents</a></li><li class="chapter-item expanded "><a href="cli/agreements.html"><strong aria-hidden="true">4.</strong> Creating and using agreements</a></li><li class="chapter-item expanded affix "><li class="part-title">Design</li><li class="chapter-item expanded "><a href="design/schemas.html"><strong aria-hidden="true">5.</strong> JSON schemas</a></li><li class="chapter-item expanded "><a href="design/security.html"><strong aria-hidden="true">6.</strong> Security</a></li><li class="chapter-item expanded "><a href="design/schemas.html"><strong aria-hidden="true">7.</strong> JSON schemas</a></li><li class="spacer"></li></ol>
+                <ol class="chapter"><li class="chapter-item expanded affix "><a href="index.html">Introduction</a></li><li class="chapter-item expanded affix "><li class="part-title">User Guide</li><li class="chapter-item expanded "><a href="cli/installation.html"><strong aria-hidden="true">1.</strong> Installation</a></li><li class="chapter-item expanded "><a href="cli/agent.html"><strong aria-hidden="true">2.</strong> Creating an Agent</a></li><li class="chapter-item expanded "><a href="cli/documents.html"><strong aria-hidden="true">3.</strong> Working with documents</a></li><li class="chapter-item expanded "><a href="cli/agreements.html"><strong aria-hidden="true">4.</strong> Creating and using agreements</a></li><li class="chapter-item expanded "><a href="wasm/building.html"><strong aria-hidden="true">5.</strong> building</a></li><li class="chapter-item expanded affix "><li class="part-title">Design</li><li class="chapter-item expanded "><a href="design/schemas.html"><strong aria-hidden="true">6.</strong> JSON schemas</a></li><li class="chapter-item expanded "><a href="design/security.html"><strong aria-hidden="true">7.</strong> Security</a></li><li class="chapter-item expanded "><a href="design/schemas.html"><strong aria-hidden="true">8.</strong> JSON schemas</a></li><li class="spacer"></li></ol>
             </div>
             <div id="sidebar-resize-handle" class="sidebar-resize-handle">
                 <div class="sidebar-resize-indicator"></div>

docs/jacsbook/book/cli/agent.html

@@ -88,7 +88,7 @@
 
         <nav id="sidebar" class="sidebar" aria-label="Table of contents">
             <div class="sidebar-scrollbox">
-                <ol class="chapter"><li class="chapter-item expanded affix "><a href="../index.html">Introduction</a></li><li class="chapter-item expanded affix "><li class="part-title">User Guide</li><li class="chapter-item expanded "><a href="../cli/installation.html"><strong aria-hidden="true">1.</strong> Installation</a></li><li class="chapter-item expanded "><a href="../cli/agent.html" class="active"><strong aria-hidden="true">2.</strong> Creating an Agent</a></li><li class="chapter-item expanded "><a href="../cli/documents.html"><strong aria-hidden="true">3.</strong> Working with documents</a></li><li class="chapter-item expanded "><a href="../cli/agreements.html"><strong aria-hidden="true">4.</strong> Creating and using agreements</a></li><li class="chapter-item expanded affix "><li class="part-title">Design</li><li class="chapter-item expanded "><a href="../design/schemas.html"><strong aria-hidden="true">5.</strong> JSON schemas</a></li><li class="chapter-item expanded "><a href="../design/security.html"><strong aria-hidden="true">6.</strong> Security</a></li><li class="chapter-item expanded "><a href="../design/schemas.html"><strong aria-hidden="true">7.</strong> JSON schemas</a></li><li class="spacer"></li></ol>
+                <ol class="chapter"><li class="chapter-item expanded affix "><a href="../index.html">Introduction</a></li><li class="chapter-item expanded affix "><li class="part-title">User Guide</li><li class="chapter-item expanded "><a href="../cli/installation.html"><strong aria-hidden="true">1.</strong> Installation</a></li><li class="chapter-item expanded "><a href="../cli/agent.html" class="active"><strong aria-hidden="true">2.</strong> Creating an Agent</a></li><li class="chapter-item expanded "><a href="../cli/documents.html"><strong aria-hidden="true">3.</strong> Working with documents</a></li><li class="chapter-item expanded "><a href="../cli/agreements.html"><strong aria-hidden="true">4.</strong> Creating and using agreements</a></li><li class="chapter-item expanded "><a href="../wasm/building.html"><strong aria-hidden="true">5.</strong> building</a></li><li class="chapter-item expanded affix "><li class="part-title">Design</li><li class="chapter-item expanded "><a href="../design/schemas.html"><strong aria-hidden="true">6.</strong> JSON schemas</a></li><li class="chapter-item expanded "><a href="../design/security.html"><strong aria-hidden="true">7.</strong> Security</a></li><li class="chapter-item expanded "><a href="../design/schemas.html"><strong aria-hidden="true">8.</strong> JSON schemas</a></li><li class="spacer"></li></ol>
             </div>
             <div id="sidebar-resize-handle" class="sidebar-resize-handle">
                 <div class="sidebar-resize-indicator"></div>

docs/jacsbook/book/cli/agreements.html

@@ -88,7 +88,7 @@
 
         <nav id="sidebar" class="sidebar" aria-label="Table of contents">
             <div class="sidebar-scrollbox">
-                <ol class="chapter"><li class="chapter-item expanded affix "><a href="../index.html">Introduction</a></li><li class="chapter-item expanded affix "><li class="part-title">User Guide</li><li class="chapter-item expanded "><a href="../cli/installation.html"><strong aria-hidden="true">1.</strong> Installation</a></li><li class="chapter-item expanded "><a href="../cli/agent.html"><strong aria-hidden="true">2.</strong> Creating an Agent</a></li><li class="chapter-item expanded "><a href="../cli/documents.html"><strong aria-hidden="true">3.</strong> Working with documents</a></li><li class="chapter-item expanded "><a href="../cli/agreements.html" class="active"><strong aria-hidden="true">4.</strong> Creating and using agreements</a></li><li class="chapter-item expanded affix "><li class="part-title">Design</li><li class="chapter-item expanded "><a href="../design/schemas.html"><strong aria-hidden="true">5.</strong> JSON schemas</a></li><li class="chapter-item expanded "><a href="../design/security.html"><strong aria-hidden="true">6.</strong> Security</a></li><li class="chapter-item expanded "><a href="../design/schemas.html"><strong aria-hidden="true">7.</strong> JSON schemas</a></li><li class="spacer"></li></ol>
+                <ol class="chapter"><li class="chapter-item expanded affix "><a href="../index.html">Introduction</a></li><li class="chapter-item expanded affix "><li class="part-title">User Guide</li><li class="chapter-item expanded "><a href="../cli/installation.html"><strong aria-hidden="true">1.</strong> Installation</a></li><li class="chapter-item expanded "><a href="../cli/agent.html"><strong aria-hidden="true">2.</strong> Creating an Agent</a></li><li class="chapter-item expanded "><a href="../cli/documents.html"><strong aria-hidden="true">3.</strong> Working with documents</a></li><li class="chapter-item expanded "><a href="../cli/agreements.html" class="active"><strong aria-hidden="true">4.</strong> Creating and using agreements</a></li><li class="chapter-item expanded "><a href="../wasm/building.html"><strong aria-hidden="true">5.</strong> building</a></li><li class="chapter-item expanded affix "><li class="part-title">Design</li><li class="chapter-item expanded "><a href="../design/schemas.html"><strong aria-hidden="true">6.</strong> JSON schemas</a></li><li class="chapter-item expanded "><a href="../design/security.html"><strong aria-hidden="true">7.</strong> Security</a></li><li class="chapter-item expanded "><a href="../design/schemas.html"><strong aria-hidden="true">8.</strong> JSON schemas</a></li><li class="spacer"></li></ol>
             </div>
             <div id="sidebar-resize-handle" class="sidebar-resize-handle">
                 <div class="sidebar-resize-indicator"></div>
@@ -198,7 +198,7 @@ <h1 id="agreements"><a class="header" href="#agreements">Agreements</a></h1>
                                 <i class="fa fa-angle-left"></i>
                             </a>
 
-                            <a rel="next prefetch" href="../design/schemas.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
+                            <a rel="next prefetch" href="../wasm/building.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
                                 <i class="fa fa-angle-right"></i>
                             </a>
 
@@ -212,7 +212,7 @@ <h1 id="agreements"><a class="header" href="#agreements">Agreements</a></h1>
                         <i class="fa fa-angle-left"></i>
                     </a>
 
-                    <a rel="next prefetch" href="../design/schemas.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
+                    <a rel="next prefetch" href="../wasm/building.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
                         <i class="fa fa-angle-right"></i>
                     </a>
             </nav>

docs/jacsbook/book/cli/documents.html

@@ -88,7 +88,7 @@
 
         <nav id="sidebar" class="sidebar" aria-label="Table of contents">
             <div class="sidebar-scrollbox">
-                <ol class="chapter"><li class="chapter-item expanded affix "><a href="../index.html">Introduction</a></li><li class="chapter-item expanded affix "><li class="part-title">User Guide</li><li class="chapter-item expanded "><a href="../cli/installation.html"><strong aria-hidden="true">1.</strong> Installation</a></li><li class="chapter-item expanded "><a href="../cli/agent.html"><strong aria-hidden="true">2.</strong> Creating an Agent</a></li><li class="chapter-item expanded "><a href="../cli/documents.html" class="active"><strong aria-hidden="true">3.</strong> Working with documents</a></li><li class="chapter-item expanded "><a href="../cli/agreements.html"><strong aria-hidden="true">4.</strong> Creating and using agreements</a></li><li class="chapter-item expanded affix "><li class="part-title">Design</li><li class="chapter-item expanded "><a href="../design/schemas.html"><strong aria-hidden="true">5.</strong> JSON schemas</a></li><li class="chapter-item expanded "><a href="../design/security.html"><strong aria-hidden="true">6.</strong> Security</a></li><li class="chapter-item expanded "><a href="../design/schemas.html"><strong aria-hidden="true">7.</strong> JSON schemas</a></li><li class="spacer"></li></ol>
+                <ol class="chapter"><li class="chapter-item expanded affix "><a href="../index.html">Introduction</a></li><li class="chapter-item expanded affix "><li class="part-title">User Guide</li><li class="chapter-item expanded "><a href="../cli/installation.html"><strong aria-hidden="true">1.</strong> Installation</a></li><li class="chapter-item expanded "><a href="../cli/agent.html"><strong aria-hidden="true">2.</strong> Creating an Agent</a></li><li class="chapter-item expanded "><a href="../cli/documents.html" class="active"><strong aria-hidden="true">3.</strong> Working with documents</a></li><li class="chapter-item expanded "><a href="../cli/agreements.html"><strong aria-hidden="true">4.</strong> Creating and using agreements</a></li><li class="chapter-item expanded "><a href="../wasm/building.html"><strong aria-hidden="true">5.</strong> building</a></li><li class="chapter-item expanded affix "><li class="part-title">Design</li><li class="chapter-item expanded "><a href="../design/schemas.html"><strong aria-hidden="true">6.</strong> JSON schemas</a></li><li class="chapter-item expanded "><a href="../design/security.html"><strong aria-hidden="true">7.</strong> Security</a></li><li class="chapter-item expanded "><a href="../design/schemas.html"><strong aria-hidden="true">8.</strong> JSON schemas</a></li><li class="spacer"></li></ol>
             </div>
             <div id="sidebar-resize-handle" class="sidebar-resize-handle">
                 <div class="sidebar-resize-indicator"></div>