JACS supports comprehensive observability through configurable logging, metrics, and tracing. All observability features are optional and can be configured in the jacs.config.json file.
+Controls how JACS generates and outputs log messages.
+Writes logs to rotating files in the specified directory.
+Outputs logs to standard error stream.
+Sends logs to an OTLP-compatible endpoint (like Jaeger, Grafana Cloud).
+Discards all log output.
+Controls collection and export of application metrics.
+Exports metrics in Prometheus format to a remote write endpoint.
+Exports metrics to an OTLP-compatible endpoint.
+Writes metrics to a local file.
+Prints metrics to standard output.
+Controls distributed tracing for request flows.
+Controls which traces are collected to manage overhead.
+Identifies the service in distributed tracing systems.
+For remote destinations (OTLP, Prometheus), you can specify authentication headers:
+The observability configuration works alongside JACS's core configuration system.
+These can be overridden by environment variables if needed, but they are primarily configured through the jacs.config.json file.
+The observability configuration is completely optional - JACS will work without any observability configuration.
+JACS doesn't automatically migrate data between storage backends - this must be done manually or via custom scripts.
+
+
+{
+ "$schema": "https://hai.ai/schemas/jacs.config.schema.json",
+ "jacs_use_security": "false",
+ "jacs_data_directory": "./jacs_data",
+ "jacs_key_directory": "./jacs_keys",
+ "jacs_agent_private_key_filename": "jacs.private.pem.enc",
+ "jacs_agent_public_key_filename": "jacs.public.pem",
+ "jacs_agent_key_algorithm": "RSA-PSS",
+ "jacs_default_storage": "fs",
+ "observability": {
+ "logs": {
+ "enabled": true,
+ "level": "info",
+ "destination": {
+ "type": "file",
+ "path": "./logs"
+ },
+ "headers": {
+ "Authorization": "Bearer token",
+ "X-API-Key": "secret"
+ }
+ },
+ "metrics": {
+ "enabled": true,
+ "destination": {
+ "type": "prometheus",
+ "endpoint": "http://localhost:9090/api/v1/write",
+ "headers": {
+ "Authorization": "Basic dXNlcjpwYXNz"
+ }
+ },
+ "export_interval_seconds": 60,
+ "headers": {
+ "X-Service": "jacs"
+ }
+ },
+ "tracing": {
+ "enabled": true,
+ "sampling": {
+ "ratio": 0.1,
+ "parent_based": true,
+ "rate_limit": 100
+ },
+ "resource": {
+ "service_name": "jacs",
+ "service_version": "0.3.6",
+ "environment": "production",
+ "attributes": {
+ "team": "platform",
+ "region": "us-west-2"
+ }
+ }
+ }
+ }
+}
+
+
+JACS supports comprehensive observability through configurable logging, metrics, and tracing. All observability features are optional and can be configured in the jacs.config.json file.
+
+Controls how JACS generates and outputs log messages.
+| Field | Type | Required | Description |
|---|
+enabled | boolean | Yes | Whether logging is enabled |
+level | string | Yes | Minimum log level: trace, debug, info, warn, error |
+destination | object | Yes | Where logs are sent (see destinations below) |
+headers | object | No | Additional headers for remote destinations |
+
+
File Logging
+{
+ "type": "file",
+ "path": "./logs"
+}
+
+Writes logs to rotating files in the specified directory.
+Console Logging (stderr)
+{
+ "type": "stderr"
+}
+
+Outputs logs to standard error stream.
+OpenTelemetry Protocol (OTLP)
+{
+ "type": "otlp",
+ "endpoint": "http://localhost:4317",
+ "headers": {
+ "Authorization": "Bearer token"
+ }
+}
+
+Sends logs to an OTLP-compatible endpoint (like Jaeger, Grafana Cloud).
+Null (disabled)
+{
+ "type": "null"
+}
+
+Discards all log output.
+
+Controls collection and export of application metrics.
+| Field | Type | Required | Description |
|---|
+enabled | boolean | Yes | Whether metrics collection is enabled |
+destination | object | Yes | Where metrics are exported (see destinations below) |
+export_interval_seconds | integer | No | How often to export metrics (default: 60) |
+headers | object | No | Additional headers for remote destinations |
+
+
Prometheus Remote Write
+{
+ "type": "prometheus",
+ "endpoint": "http://localhost:9090/api/v1/write",
+ "headers": {
+ "Authorization": "Basic dXNlcjpwYXNz"
+ }
+}
+
+Exports metrics in Prometheus format to a remote write endpoint.
+OpenTelemetry Protocol (OTLP)
+{
+ "type": "otlp",
+ "endpoint": "http://localhost:4317",
+ "headers": {
+ "Authorization": "Bearer token"
+ }
+}
+
+Exports metrics to an OTLP-compatible endpoint.
+File Export
+{
+ "type": "file",
+ "path": "./metrics.txt"
+}
+
+Writes metrics to a local file.
+Console Output (stdout)
+{
+ "type": "stdout"
+}
+
+Prints metrics to standard output.
+
+Controls distributed tracing for request flows.
+| Field | Type | Required | Description |
|---|
+enabled | boolean | Yes | Whether tracing is enabled |
+sampling | object | No | Sampling configuration (see below) |
+resource | object | No | Service identification (see below) |
+
+
Controls which traces are collected to manage overhead.
+| Field | Type | Default | Description |
|---|
+ratio | number | 1.0 | Fraction of traces to sample (0.0-1.0) |
+parent_based | boolean | true | Whether to respect parent trace sampling decisions |
+rate_limit | integer | none | Maximum traces per second |
+
+
Examples:
+
+"ratio": 1.0 - Sample all traces (100%)"ratio": 0.1 - Sample 10% of traces"ratio": 0.01 - Sample 1% of traces"rate_limit": 10 - Maximum 10 traces per second
+
+Identifies the service in distributed tracing systems.
+| Field | Type | Required | Description |
|---|
+service_name | string | Yes | Name of the service |
+service_version | string | No | Version of the service |
+environment | string | No | Environment (dev, staging, prod) |
+attributes | object | No | Custom key-value attributes |
+
+
For remote destinations (OTLP, Prometheus), you can specify authentication headers:
+Bearer Token Authentication:
+"headers": {
+ "Authorization": "Bearer your-token-here"
+}
+
+Basic Authentication:
+"headers": {
+ "Authorization": "Basic dXNlcjpwYXNz"
+}
+
+API Key Authentication:
+"headers": {
+ "X-API-Key": "your-api-key",
+ "X-Auth-Token": "your-auth-token"
+}
+
+
+
+"observability": {
+ "logs": {
+ "enabled": true,
+ "level": "debug",
+ "destination": { "type": "stderr" }
+ },
+ "metrics": {
+ "enabled": true,
+ "destination": { "type": "stdout" }
+ }
+}
+
+
+"observability": {
+ "logs": {
+ "enabled": true,
+ "level": "info",
+ "destination": {
+ "type": "otlp",
+ "endpoint": "https://logs.example.com:4317",
+ "headers": {
+ "Authorization": "Bearer prod-token"
+ }
+ }
+ },
+ "metrics": {
+ "enabled": true,
+ "destination": {
+ "type": "prometheus",
+ "endpoint": "https://metrics.example.com/api/v1/write"
+ },
+ "export_interval_seconds": 30
+ },
+ "tracing": {
+ "enabled": true,
+ "sampling": {
+ "ratio": 0.05,
+ "rate_limit": 100
+ },
+ "resource": {
+ "service_name": "jacs",
+ "service_version": "0.3.6",
+ "environment": "production"
+ }
+ }
+}
+
+
+"observability": {
+ "logs": {
+ "enabled": true,
+ "level": "info",
+ "destination": {
+ "type": "file",
+ "path": "/var/log/jacs"
+ }
+ },
+ "metrics": {
+ "enabled": true,
+ "destination": {
+ "type": "file",
+ "path": "/var/log/jacs/metrics.txt"
+ },
+ "export_interval_seconds": 60
+ }
+}
+
+
+The observability configuration works alongside JACS's core configuration system.
+
+Only one environment variable is truly required:
+
+JACS_PRIVATE_KEY_PASSWORD - Password for encrypting/decrypting private keys (required for cryptographic operations)
+
+All other JACS settings are configuration file fields that have sensible defaults:
+
+jacs_data_directory - Where agent/document data is stored (default: ./jacs_data)jacs_key_directory - Where cryptographic keys are stored (default: ./jacs_keys)jacs_agent_key_algorithm - Cryptographic algorithm to use (default: RSA-PSS)jacs_default_storage - Storage backend (default: fs)jacs_use_security - Enable security features (default: false)
+These can be overridden by environment variables if needed, but they are primarily configured through the jacs.config.json file.
+The observability configuration is completely optional - JACS will work without any observability configuration.
+
+The jacs_default_storage field determines where JACS stores agent data, documents, and keys. This is a critical configuration that affects how your data is persisted and accessed.
+
+| Backend | Value | Description | Use Case |
|---|
+| Filesystem | "fs" | Local file system storage | Development, single-node deployments |
+| AWS S3 | "aws" | Amazon S3 object storage | Production, cloud deployments |
+| HAI Remote | "hai" | HAI.ai remote storage service | HAI.ai platform integration |
+| Memory | "memory" | In-memory storage (non-persistent) | Testing, temporary data |
+| Web Local | "local" | Browser local storage (WASM only) | Web applications |
+
+
{
+ "jacs_default_storage": "fs",
+ "jacs_data_directory": "./jacs_data",
+ "jacs_key_directory": "./jacs_keys"
+}
+
+Requirements: None - works out of the box
+Data location: Local directories as specified in config
+Best for: Development, local testing, single-machine deployments
+
+{
+ "jacs_default_storage": "aws"
+}
+
+Required Environment Variables:
+
+JACS_ENABLE_AWS_BUCKET_NAME - S3 bucket nameAWS_ACCESS_KEY_ID - AWS access keyAWS_SECRET_ACCESS_KEY - AWS secret keyAWS_REGION - AWS region (optional, defaults to us-east-1)
+Best for: Production deployments, distributed systems, cloud-native applications
+
+{
+ "jacs_default_storage": "hai"
+}
+
+Required Environment Variables:
+
+HAI_STORAGE_URL - HAI.ai storage service endpoint
+Best for: Integration with HAI.ai platform services
+
+{
+ "jacs_default_storage": "memory"
+}
+
+Requirements: None
+Data persistence: None - data is lost when application stops
+Best for: Unit testing, temporary operations, development scenarios
+
+
+- Agent data (agent definitions, signatures) are stored using the configured backend
+- Documents are stored using the configured backend
+- Cryptographic keys are stored using the configured backend
+- Observability data (logs, metrics) can use separate storage via observability configuration
+
+
+Development Setup (Filesystem)
+{
+ "jacs_default_storage": "fs",
+ "jacs_data_directory": "./dev_data",
+ "jacs_key_directory": "./dev_keys"
+}
+
+Production Setup (AWS S3)
+{
+ "jacs_default_storage": "aws"
+}
+
+With environment variables:
+export JACS_ENABLE_AWS_BUCKET_NAME="my-jacs-production-bucket"
+export AWS_ACCESS_KEY_ID="AKIA..."
+export AWS_SECRET_ACCESS_KEY="..."
+export AWS_REGION="us-west-2"
+
+HAI Platform Integration
+{
+ "jacs_default_storage": "hai"
+}
+
+With environment variable:
+export HAI_STORAGE_URL="https://storage.hai.ai/v1"
+
+
+
+- AWS S3: Ensure proper IAM permissions for bucket access
+- HAI Remote: Secure the
HAI_STORAGE_URL endpoint and any required authentication
+- Filesystem: Ensure proper file system permissions for data and key directories
+- Keys: Regardless of storage backend, always set
JACS_PRIVATE_KEY_PASSWORD for key encryption
+
+
+When changing storage backends, you'll need to:
+
+- Export existing data from the current backend
+- Update the
jacs_default_storage configuration
+- Set any required environment variables for the new backend
+- Import data into the new backend
+
+JACS doesn't automatically migrate data between storage backends - this must be done manually or via custom scripts.
diff --git a/jacs/docs/jacsbook/book/searchindex.js b/jacs/docs/jacsbook/book/searchindex.js
index 3aba4a315..8ee65260b 100644
--- a/jacs/docs/jacsbook/book/searchindex.js
+++ b/jacs/docs/jacsbook/book/searchindex.js
@@ -1 +1 @@
-Object.assign(window.search, {"doc_urls":["index.html#jacs-json-agent-communication-standard","index.html#what-is-jacs","index.html#key-features","index.html#available-implementations","index.html#-rust-core-library--cli","index.html#-nodejs-jacsnpm","index.html#-python-jacspy","index.html#quick-start","index.html#rust-cli","index.html#nodejs","index.html#python","index.html#when-to-use-jacs","index.html#why-jacs","index.html#--agent-focused-design","index.html#--production-ready","index.html#--future-proof-security","index.html#--universal-compatibility","index.html#--flexible-integration","index.html#getting-started","index.html#community-and-support","getting-started/what-is-jacs.html#what-is-jacs","getting-started/what-is-jacs.html#the-problem-jacs-solves","getting-started/what-is-jacs.html#jacs-core-philosophy","getting-started/what-is-jacs.html#--agent-first-design","getting-started/what-is-jacs.html#--trust-through-cryptography","getting-started/what-is-jacs.html#--standards-based","getting-started/what-is-jacs.html#key-concepts","getting-started/what-is-jacs.html#agents","getting-started/what-is-jacs.html#documents","getting-started/what-is-jacs.html#tasks","getting-started/what-is-jacs.html#agreements","getting-started/what-is-jacs.html#how-jacs-works","getting-started/what-is-jacs.html#real-world-examples","getting-started/what-is-jacs.html#--ai-content-pipeline","getting-started/what-is-jacs.html#--data-processing-workflow","getting-started/what-is-jacs.html#--multi-agent-analysis","getting-started/what-is-jacs.html#benefits-over-alternatives","getting-started/what-is-jacs.html#when-to-use-jacs","getting-started/what-is-jacs.html#next-steps","getting-started/concepts.html#core-concepts","getting-started/concepts.html#agents","getting-started/concepts.html#agent-identity","getting-started/concepts.html#agent-lifecycle","getting-started/concepts.html#documents","getting-started/concepts.html#document-structure","getting-started/concepts.html#required-jacs-fields","getting-started/concepts.html#document-types","getting-started/concepts.html#tasks","getting-started/concepts.html#task-structure","getting-started/concepts.html#task-lifecycle","getting-started/concepts.html#task-components","getting-started/concepts.html#agreements","getting-started/concepts.html#agreement-structure","getting-started/concepts.html#agreement-process","getting-started/concepts.html#agreement-types","getting-started/concepts.html#cryptographic-security","getting-started/concepts.html#supported-algorithms","getting-started/concepts.html#signature-process","getting-started/concepts.html#key-management","getting-started/concepts.html#versioning-and-audit-trails","getting-started/concepts.html#version-management","getting-started/concepts.html#audit-trail-benefits","getting-started/concepts.html#storage-and-transport","getting-started/concepts.html#storage-options","getting-started/concepts.html#transport-mechanisms","getting-started/concepts.html#format-compatibility","getting-started/concepts.html#next-steps","getting-started/quick-start.html#quick-start-guide","getting-started/quick-start.html#choose-your-implementation","getting-started/quick-start.html#install-rust-cli","getting-started/quick-start.html#initialize-jacs","getting-started/quick-start.html#create-your-first-agent","getting-started/quick-start.html#create-and-sign-a-task","getting-started/quick-start.html#install-nodejs-package","getting-started/quick-start.html#basic-setup","getting-started/quick-start.html#create-agent-document","getting-started/quick-start.html#create-a-task","getting-started/quick-start.html#install-python-package","getting-started/quick-start.html#basic-setup-1","getting-started/quick-start.html#create-agent-document-1","getting-started/quick-start.html#create-a-task-1","getting-started/quick-start.html#understanding-what-happened","getting-started/quick-start.html#1--agent-creation","getting-started/quick-start.html#2--configuration-setup","getting-started/quick-start.html#3--task-creation","getting-started/quick-start.html#verify-everything-works","getting-started/quick-start.html#next-steps-multi-agent-workflow","getting-started/quick-start.html#what-youve-accomplished","getting-started/quick-start.html#key-takeaways","getting-started/quick-start.html#where-to-go-next","getting-started/quick-start.html#troubleshooting","rust/installation.html#installation","rust/cli.html#cli-usage","rust/agent.html#creating-an-agent","rust/documents.html#working-with-documents","rust/agreements.html#creating-and-using-agreements","rust/library.html#rust-library-api","rust/observability.html#observability","nodejs/installation.html#nodejs-installation","nodejs/installation.html#requirements","nodejs/installation.html#installation","nodejs/installation.html#using-npm","nodejs/installation.html#using-yarn","nodejs/installation.html#using-pnpm","nodejs/installation.html#verify-installation","nodejs/installation.html#package-structure","nodejs/installation.html#core-module-jacsnpm","nodejs/installation.html#mcp-integration-jacsnpmmcp","nodejs/installation.html#http-server-jacsnpmhttp","nodejs/installation.html#typescript-support","nodejs/installation.html#configuration","nodejs/installation.html#basic-configuration","nodejs/installation.html#configuration-file","nodejs/installation.html#environment-variables","nodejs/installation.html#storage-backends","nodejs/installation.html#file-system-default","nodejs/installation.html#s3-storage","nodejs/installation.html#azure-blob-storage","nodejs/installation.html#cryptographic-algorithms","nodejs/installation.html#ed25519-recommended","nodejs/installation.html#rsa-pss","nodejs/installation.html#post-quantum-experimental","nodejs/installation.html#development-setup","nodejs/installation.html#project-structure","nodejs/installation.html#packagejson-setup","nodejs/installation.html#basic-application","nodejs/installation.html#common-issues","nodejs/installation.html#module-not-found","nodejs/installation.html#permission-errors","nodejs/installation.html#binary-compatibility","nodejs/installation.html#typescript-issues","nodejs/installation.html#next-steps","nodejs/installation.html#examples","nodejs/basic-usage.html#basic-usage","nodejs/mcp.html#model-context-protocol-mcp-integration","nodejs/mcp.html#what-is-mcp","nodejs/mcp.html#quick-start","nodejs/mcp.html#basic-mcp-server","nodejs/mcp.html#using-with-existing-mcp-server","nodejs/mcp.html#available-tools","nodejs/mcp.html#agent-management","nodejs/mcp.html#task-management","nodejs/mcp.html#agreement-management","nodejs/mcp.html#document-operations","nodejs/mcp.html#configuration","nodejs/mcp.html#server-configuration","nodejs/mcp.html#middleware-configuration","nodejs/mcp.html#tool-usage-examples","nodejs/mcp.html#creating-a-task","nodejs/mcp.html#creating-an-agreement","nodejs/mcp.html#verifying-documents","nodejs/mcp.html#advanced-integration","nodejs/mcp.html#custom-tools","nodejs/mcp.html#multi-agent-workflows","nodejs/mcp.html#transport-options","nodejs/mcp.html#stdio-transport-default","nodejs/mcp.html#sse-transport-http","nodejs/mcp.html#websocket-transport","nodejs/mcp.html#client-integration","nodejs/mcp.html#using-jacs-with-mcp-clients","nodejs/mcp.html#security-considerations","nodejs/mcp.html#signature-verification","nodejs/mcp.html#agent-authentication","nodejs/mcp.html#monitoring-and-observability","nodejs/mcp.html#request-logging","nodejs/mcp.html#metrics-collection","nodejs/mcp.html#examples","nodejs/mcp.html#troubleshooting","nodejs/mcp.html#connection-issues","nodejs/mcp.html#tool-registration-problems","nodejs/mcp.html#signature-verification-failures","nodejs/http.html#http-server","nodejs/express.html#express-middleware","nodejs/api.html#api-reference","python/installation.html#python-installation","python/installation.html#requirements","python/installation.html#installation","python/installation.html#using-pip","python/installation.html#using-conda","python/installation.html#using-poetry","python/installation.html#development-installation","python/installation.html#verify-installation","python/installation.html#package-structure","python/installation.html#core-module","python/installation.html#mcp-integration","python/installation.html#fastmcp-integration","python/installation.html#configuration","python/installation.html#basic-configuration","python/installation.html#configuration-file","python/installation.html#environment-variables","python/installation.html#storage-backends","python/installation.html#file-system-default","python/installation.html#s3-storage","python/installation.html#azure-blob-storage","python/installation.html#cryptographic-algorithms","python/installation.html#ed25519-recommended","python/installation.html#rsa-pss","python/installation.html#post-quantum-experimental","python/installation.html#development-setup","python/installation.html#project-structure","python/installation.html#requirementstxt-setup","python/installation.html#basic-application","python/installation.html#virtual-environment-setup","python/installation.html#using-venv","python/installation.html#using-conda-1","python/installation.html#using-poetry-1","python/installation.html#jupyter-notebook-setup","python/installation.html#common-issues","python/installation.html#module-not-found","python/installation.html#permission-errors","python/installation.html#binary-compatibility","python/installation.html#windows-issues","python/installation.html#type-hints-and-ide-support","python/installation.html#testing-setup","python/installation.html#next-steps","python/installation.html#examples","python/basic-usage.html#basic-usage","python/basic-usage.html#quick-start-example","python/basic-usage.html#agent-management","python/basic-usage.html#creating-an-agent","python/basic-usage.html#loading-an-existing-agent","python/basic-usage.html#agent-information","python/basic-usage.html#task-management","python/basic-usage.html#creating-tasks","python/basic-usage.html#updating-tasks","python/basic-usage.html#querying-tasks","python/basic-usage.html#document-management","python/basic-usage.html#creating-documents","python/basic-usage.html#document-versioning","python/basic-usage.html#document-verification","python/basic-usage.html#agreement-management","python/basic-usage.html#creating-agreements","python/basic-usage.html#agreement-workflow","python/basic-usage.html#working-with-json-schemas","python/basic-usage.html#schema-validation","python/basic-usage.html#error-handling","python/basic-usage.html#common-error-patterns","python/basic-usage.html#robust-error-handling","python/basic-usage.html#configuration-management","python/basic-usage.html#environment-based-configuration","python/basic-usage.html#configuration-validation","python/basic-usage.html#performance-tips","python/basic-usage.html#batch-operations","python/basic-usage.html#caching-agent-instance","python/basic-usage.html#next-steps","python/basic-usage.html#common-patterns","python/basic-usage.html#task-pipeline","python/mcp.html#mcp-integration","python/mcp.html#overview","python/mcp.html#quick-start","python/mcp.html#basic-mcp-server-with-jacs","python/mcp.html#basic-mcp-client-with-jacs","python/mcp.html#configuration","python/mcp.html#jacs-configuration-file","python/mcp.html#key-generation","python/mcp.html#integration-patterns","python/mcp.html#1-fastmcp-with-jacs-middleware","python/mcp.html#2-http-mcp-with-manual-signing","python/mcp.html#3-standard-mcp-with-stdio","python/mcp.html#advanced-usage","python/mcp.html#custom-authentication-logic","python/mcp.html#multi-agent-authentication","python/mcp.html#error-handling","python/mcp.html#common-jacs-mcp-errors","python/mcp.html#debugging-authentication-issues","python/mcp.html#production-deployment","python/mcp.html#security-best-practices","python/mcp.html#docker-deployment","python/mcp.html#testing","python/mcp.html#unit-testing-mcp-tools","python/mcp.html#performance-considerations","python/mcp.html#optimization-tips","python/mcp.html#next-steps","python/api.html#api-reference","schemas/overview.html#json-schemas","schemas/agent.html#agent-schema","schemas/document.html#document-schema","schemas/task.html#task-schema","schemas/configuration.html#configuration","advanced/security.html#security-model","advanced/crypto.html#cryptographic-algorithms","advanced/storage.html#storage-backends","advanced/custom-schemas.html#custom-schemas","advanced/testing.html#testing","integrations/mcp.html#model-context-protocol-mcp","integrations/web-servers.html#web-servers","integrations/databases.html#databases","examples/cli.html#cli-examples","examples/nodejs.html#nodejs-examples","examples/python.html#python-examples","examples/integrations.html#integration-examples","reference/cli-commands.html#cli-command-reference","reference/cli-commands.html#global-commands","reference/cli-commands.html#jacs-version","reference/cli-commands.html#jacs-init","reference/cli-commands.html#jacs-help","reference/cli-commands.html#configuration-commands","reference/cli-commands.html#jacs-config","reference/cli-commands.html#agent-commands","reference/cli-commands.html#jacs-agent","reference/cli-commands.html#task-commands","reference/cli-commands.html#jacs-task","reference/cli-commands.html#document-commands","reference/cli-commands.html#jacs-document-create","reference/cli-commands.html#jacs-document-update","reference/cli-commands.html#jacs-document-verify","reference/cli-commands.html#jacs-document-extract","reference/cli-commands.html#agreement-commands","reference/cli-commands.html#common-patterns","reference/cli-commands.html#basic-document-lifecycle","reference/cli-commands.html#working-with-attachments","reference/cli-commands.html#schema-validation-workflow","reference/cli-commands.html#global-options","reference/cli-commands.html#exit-codes","reference/cli-commands.html#environment-variables","reference/cli-commands.html#file-formats","reference/cli-commands.html#input-files","reference/cli-commands.html#output-files","reference/configuration.html#configuration-reference","reference/errors.html#error-codes","reference/migration.html#migration-guide"],"index":{"documentStore":{"docInfo":{"0":{"body":24,"breadcrumbs":6,"title":5},"1":{"body":48,"breadcrumbs":2,"title":1},"10":{"body":7,"breadcrumbs":2,"title":1},"100":{"body":0,"breadcrumbs":2,"title":1},"101":{"body":3,"breadcrumbs":3,"title":2},"102":{"body":3,"breadcrumbs":3,"title":2},"103":{"body":3,"breadcrumbs":3,"title":2},"104":{"body":46,"breadcrumbs":3,"title":2},"105":{"body":5,"breadcrumbs":3,"title":2},"106":{"body":6,"breadcrumbs":4,"title":3},"107":{"body":4,"breadcrumbs":4,"title":3},"108":{"body":4,"breadcrumbs":4,"title":3},"109":{"body":36,"breadcrumbs":3,"title":2},"11":{"body":39,"breadcrumbs":3,"title":2},"110":{"body":0,"breadcrumbs":2,"title":1},"111":{"body":31,"breadcrumbs":3,"title":2},"112":{"body":25,"breadcrumbs":3,"title":2},"113":{"body":23,"breadcrumbs":3,"title":2},"114":{"body":0,"breadcrumbs":3,"title":2},"115":{"body":8,"breadcrumbs":4,"title":3},"116":{"body":12,"breadcrumbs":3,"title":2},"117":{"body":10,"breadcrumbs":4,"title":3},"118":{"body":0,"breadcrumbs":3,"title":2},"119":{"body":15,"breadcrumbs":3,"title":2},"12":{"body":0,"breadcrumbs":2,"title":1},"120":{"body":13,"breadcrumbs":3,"title":2},"121":{"body":11,"breadcrumbs":4,"title":3},"122":{"body":0,"breadcrumbs":3,"title":2},"123":{"body":15,"breadcrumbs":3,"title":2},"124":{"body":22,"breadcrumbs":3,"title":2},"125":{"body":49,"breadcrumbs":3,"title":2},"126":{"body":0,"breadcrumbs":3,"title":2},"127":{"body":19,"breadcrumbs":3,"title":2},"128":{"body":20,"breadcrumbs":3,"title":2},"129":{"body":15,"breadcrumbs":3,"title":2},"13":{"body":16,"breadcrumbs":4,"title":3},"130":{"body":12,"breadcrumbs":3,"title":2},"131":{"body":31,"breadcrumbs":3,"title":2},"132":{"body":17,"breadcrumbs":2,"title":1},"133":{"body":0,"breadcrumbs":4,"title":2},"134":{"body":23,"breadcrumbs":7,"title":5},"135":{"body":32,"breadcrumbs":3,"title":1},"136":{"body":0,"breadcrumbs":4,"title":2},"137":{"body":33,"breadcrumbs":5,"title":3},"138":{"body":22,"breadcrumbs":6,"title":4},"139":{"body":6,"breadcrumbs":4,"title":2},"14":{"body":13,"breadcrumbs":3,"title":2},"140":{"body":17,"breadcrumbs":4,"title":2},"141":{"body":17,"breadcrumbs":4,"title":2},"142":{"body":17,"breadcrumbs":4,"title":2},"143":{"body":15,"breadcrumbs":4,"title":2},"144":{"body":0,"breadcrumbs":3,"title":1},"145":{"body":34,"breadcrumbs":4,"title":2},"146":{"body":32,"breadcrumbs":4,"title":2},"147":{"body":0,"breadcrumbs":5,"title":3},"148":{"body":62,"breadcrumbs":4,"title":2},"149":{"body":37,"breadcrumbs":4,"title":2},"15":{"body":13,"breadcrumbs":4,"title":3},"150":{"body":17,"breadcrumbs":4,"title":2},"151":{"body":0,"breadcrumbs":4,"title":2},"152":{"body":80,"breadcrumbs":4,"title":2},"153":{"body":77,"breadcrumbs":5,"title":3},"154":{"body":0,"breadcrumbs":4,"title":2},"155":{"body":13,"breadcrumbs":5,"title":3},"156":{"body":15,"breadcrumbs":5,"title":3},"157":{"body":15,"breadcrumbs":4,"title":2},"158":{"body":0,"breadcrumbs":4,"title":2},"159":{"body":69,"breadcrumbs":6,"title":4},"16":{"body":12,"breadcrumbs":3,"title":2},"160":{"body":0,"breadcrumbs":4,"title":2},"161":{"body":49,"breadcrumbs":4,"title":2},"162":{"body":45,"breadcrumbs":4,"title":2},"163":{"body":0,"breadcrumbs":4,"title":2},"164":{"body":26,"breadcrumbs":4,"title":2},"165":{"body":30,"breadcrumbs":4,"title":2},"166":{"body":30,"breadcrumbs":3,"title":1},"167":{"body":0,"breadcrumbs":3,"title":1},"168":{"body":21,"breadcrumbs":4,"title":2},"169":{"body":18,"breadcrumbs":5,"title":3},"17":{"body":13,"breadcrumbs":3,"title":2},"170":{"body":30,"breadcrumbs":5,"title":3},"171":{"body":0,"breadcrumbs":4,"title":2},"172":{"body":0,"breadcrumbs":4,"title":2},"173":{"body":0,"breadcrumbs":4,"title":2},"174":{"body":21,"breadcrumbs":3,"title":2},"175":{"body":16,"breadcrumbs":2,"title":1},"176":{"body":0,"breadcrumbs":2,"title":1},"177":{"body":3,"breadcrumbs":3,"title":2},"178":{"body":6,"breadcrumbs":3,"title":2},"179":{"body":3,"breadcrumbs":3,"title":2},"18":{"body":21,"breadcrumbs":3,"title":2},"180":{"body":24,"breadcrumbs":3,"title":2},"181":{"body":45,"breadcrumbs":3,"title":2},"182":{"body":5,"breadcrumbs":3,"title":2},"183":{"body":10,"breadcrumbs":3,"title":2},"184":{"body":9,"breadcrumbs":3,"title":2},"185":{"body":11,"breadcrumbs":3,"title":2},"186":{"body":0,"breadcrumbs":2,"title":1},"187":{"body":30,"breadcrumbs":3,"title":2},"188":{"body":23,"breadcrumbs":3,"title":2},"189":{"body":24,"breadcrumbs":3,"title":2},"19":{"body":21,"breadcrumbs":3,"title":2},"190":{"body":0,"breadcrumbs":3,"title":2},"191":{"body":7,"breadcrumbs":4,"title":3},"192":{"body":11,"breadcrumbs":3,"title":2},"193":{"body":9,"breadcrumbs":4,"title":3},"194":{"body":0,"breadcrumbs":3,"title":2},"195":{"body":14,"breadcrumbs":3,"title":2},"196":{"body":12,"breadcrumbs":3,"title":2},"197":{"body":10,"breadcrumbs":4,"title":3},"198":{"body":0,"breadcrumbs":3,"title":2},"199":{"body":17,"breadcrumbs":3,"title":2},"2":{"body":51,"breadcrumbs":3,"title":2},"20":{"body":19,"breadcrumbs":2,"title":1},"200":{"body":10,"breadcrumbs":3,"title":2},"201":{"body":56,"breadcrumbs":3,"title":2},"202":{"body":0,"breadcrumbs":4,"title":3},"203":{"body":22,"breadcrumbs":3,"title":2},"204":{"body":20,"breadcrumbs":3,"title":2},"205":{"body":19,"breadcrumbs":3,"title":2},"206":{"body":44,"breadcrumbs":4,"title":3},"207":{"body":0,"breadcrumbs":3,"title":2},"208":{"body":25,"breadcrumbs":3,"title":2},"209":{"body":20,"breadcrumbs":3,"title":2},"21":{"body":60,"breadcrumbs":4,"title":3},"210":{"body":18,"breadcrumbs":3,"title":2},"211":{"body":20,"breadcrumbs":3,"title":2},"212":{"body":41,"breadcrumbs":5,"title":4},"213":{"body":57,"breadcrumbs":3,"title":2},"214":{"body":27,"breadcrumbs":3,"title":2},"215":{"body":20,"breadcrumbs":2,"title":1},"216":{"body":12,"breadcrumbs":4,"title":2},"217":{"body":94,"breadcrumbs":5,"title":3},"218":{"body":0,"breadcrumbs":4,"title":2},"219":{"body":45,"breadcrumbs":4,"title":2},"22":{"body":0,"breadcrumbs":4,"title":3},"220":{"body":29,"breadcrumbs":5,"title":3},"221":{"body":12,"breadcrumbs":4,"title":2},"222":{"body":0,"breadcrumbs":4,"title":2},"223":{"body":55,"breadcrumbs":4,"title":2},"224":{"body":40,"breadcrumbs":4,"title":2},"225":{"body":24,"breadcrumbs":4,"title":2},"226":{"body":0,"breadcrumbs":4,"title":2},"227":{"body":33,"breadcrumbs":4,"title":2},"228":{"body":31,"breadcrumbs":4,"title":2},"229":{"body":16,"breadcrumbs":4,"title":2},"23":{"body":27,"breadcrumbs":4,"title":3},"230":{"body":0,"breadcrumbs":4,"title":2},"231":{"body":35,"breadcrumbs":4,"title":2},"232":{"body":37,"breadcrumbs":4,"title":2},"233":{"body":0,"breadcrumbs":5,"title":3},"234":{"body":78,"breadcrumbs":4,"title":2},"235":{"body":0,"breadcrumbs":4,"title":2},"236":{"body":68,"breadcrumbs":5,"title":3},"237":{"body":65,"breadcrumbs":5,"title":3},"238":{"body":0,"breadcrumbs":4,"title":2},"239":{"body":54,"breadcrumbs":5,"title":3},"24":{"body":19,"breadcrumbs":4,"title":3},"240":{"body":58,"breadcrumbs":4,"title":2},"241":{"body":0,"breadcrumbs":4,"title":2},"242":{"body":21,"breadcrumbs":4,"title":2},"243":{"body":41,"breadcrumbs":5,"title":3},"244":{"body":25,"breadcrumbs":4,"title":2},"245":{"body":0,"breadcrumbs":4,"title":2},"246":{"body":66,"breadcrumbs":4,"title":2},"247":{"body":29,"breadcrumbs":4,"title":2},"248":{"body":33,"breadcrumbs":3,"title":1},"249":{"body":0,"breadcrumbs":4,"title":2},"25":{"body":22,"breadcrumbs":3,"title":2},"250":{"body":85,"breadcrumbs":6,"title":4},"251":{"body":68,"breadcrumbs":6,"title":4},"252":{"body":0,"breadcrumbs":3,"title":1},"253":{"body":27,"breadcrumbs":5,"title":3},"254":{"body":37,"breadcrumbs":4,"title":2},"255":{"body":0,"breadcrumbs":4,"title":2},"256":{"body":34,"breadcrumbs":6,"title":4},"257":{"body":47,"breadcrumbs":7,"title":5},"258":{"body":39,"breadcrumbs":6,"title":4},"259":{"body":0,"breadcrumbs":4,"title":2},"26":{"body":0,"breadcrumbs":3,"title":2},"260":{"body":70,"breadcrumbs":5,"title":3},"261":{"body":52,"breadcrumbs":5,"title":3},"262":{"body":0,"breadcrumbs":4,"title":2},"263":{"body":57,"breadcrumbs":6,"title":4},"264":{"body":21,"breadcrumbs":5,"title":3},"265":{"body":0,"breadcrumbs":4,"title":2},"266":{"body":45,"breadcrumbs":5,"title":3},"267":{"body":40,"breadcrumbs":4,"title":2},"268":{"body":0,"breadcrumbs":3,"title":1},"269":{"body":48,"breadcrumbs":6,"title":4},"27":{"body":16,"breadcrumbs":2,"title":1},"270":{"body":0,"breadcrumbs":4,"title":2},"271":{"body":51,"breadcrumbs":4,"title":2},"272":{"body":19,"breadcrumbs":4,"title":2},"273":{"body":0,"breadcrumbs":4,"title":2},"274":{"body":0,"breadcrumbs":4,"title":2},"275":{"body":0,"breadcrumbs":4,"title":2},"276":{"body":0,"breadcrumbs":4,"title":2},"277":{"body":0,"breadcrumbs":4,"title":2},"278":{"body":0,"breadcrumbs":2,"title":1},"279":{"body":0,"breadcrumbs":4,"title":2},"28":{"body":21,"breadcrumbs":2,"title":1},"280":{"body":0,"breadcrumbs":4,"title":2},"281":{"body":0,"breadcrumbs":4,"title":2},"282":{"body":0,"breadcrumbs":4,"title":2},"283":{"body":0,"breadcrumbs":2,"title":1},"284":{"body":0,"breadcrumbs":8,"title":4},"285":{"body":0,"breadcrumbs":4,"title":2},"286":{"body":0,"breadcrumbs":2,"title":1},"287":{"body":0,"breadcrumbs":4,"title":2},"288":{"body":0,"breadcrumbs":4,"title":2},"289":{"body":0,"breadcrumbs":4,"title":2},"29":{"body":14,"breadcrumbs":2,"title":1},"290":{"body":0,"breadcrumbs":4,"title":2},"291":{"body":9,"breadcrumbs":6,"title":3},"292":{"body":0,"breadcrumbs":5,"title":2},"293":{"body":8,"breadcrumbs":5,"title":2},"294":{"body":17,"breadcrumbs":5,"title":2},"295":{"body":8,"breadcrumbs":5,"title":2},"296":{"body":0,"breadcrumbs":5,"title":2},"297":{"body":15,"breadcrumbs":5,"title":2},"298":{"body":0,"breadcrumbs":5,"title":2},"299":{"body":20,"breadcrumbs":5,"title":2},"3":{"body":6,"breadcrumbs":3,"title":2},"30":{"body":20,"breadcrumbs":2,"title":1},"300":{"body":0,"breadcrumbs":5,"title":2},"301":{"body":20,"breadcrumbs":5,"title":2},"302":{"body":8,"breadcrumbs":5,"title":2},"303":{"body":157,"breadcrumbs":6,"title":3},"304":{"body":112,"breadcrumbs":6,"title":3},"305":{"body":105,"breadcrumbs":6,"title":3},"306":{"body":86,"breadcrumbs":6,"title":3},"307":{"body":61,"breadcrumbs":5,"title":2},"308":{"body":0,"breadcrumbs":5,"title":2},"309":{"body":49,"breadcrumbs":6,"title":3},"31":{"body":64,"breadcrumbs":3,"title":2},"310":{"body":42,"breadcrumbs":5,"title":2},"311":{"body":21,"breadcrumbs":6,"title":3},"312":{"body":24,"breadcrumbs":5,"title":2},"313":{"body":22,"breadcrumbs":5,"title":2},"314":{"body":18,"breadcrumbs":5,"title":2},"315":{"body":0,"breadcrumbs":5,"title":2},"316":{"body":27,"breadcrumbs":5,"title":2},"317":{"body":14,"breadcrumbs":5,"title":2},"318":{"body":0,"breadcrumbs":4,"title":2},"319":{"body":0,"breadcrumbs":4,"title":2},"32":{"body":0,"breadcrumbs":4,"title":3},"320":{"body":0,"breadcrumbs":4,"title":2},"33":{"body":17,"breadcrumbs":4,"title":3},"34":{"body":17,"breadcrumbs":4,"title":3},"35":{"body":17,"breadcrumbs":4,"title":3},"36":{"body":56,"breadcrumbs":4,"title":3},"37":{"body":41,"breadcrumbs":3,"title":2},"38":{"body":19,"breadcrumbs":3,"title":2},"39":{"body":16,"breadcrumbs":4,"title":2},"4":{"body":27,"breadcrumbs":5,"title":4},"40":{"body":10,"breadcrumbs":3,"title":1},"41":{"body":50,"breadcrumbs":4,"title":2},"42":{"body":24,"breadcrumbs":4,"title":2},"43":{"body":10,"breadcrumbs":3,"title":1},"44":{"body":57,"breadcrumbs":4,"title":2},"45":{"body":48,"breadcrumbs":5,"title":3},"46":{"body":51,"breadcrumbs":4,"title":2},"47":{"body":8,"breadcrumbs":3,"title":1},"48":{"body":40,"breadcrumbs":4,"title":2},"49":{"body":32,"breadcrumbs":4,"title":2},"5":{"body":25,"breadcrumbs":3,"title":2},"50":{"body":37,"breadcrumbs":4,"title":2},"51":{"body":8,"breadcrumbs":3,"title":1},"52":{"body":67,"breadcrumbs":4,"title":2},"53":{"body":33,"breadcrumbs":4,"title":2},"54":{"body":26,"breadcrumbs":4,"title":2},"55":{"body":7,"breadcrumbs":4,"title":2},"56":{"body":28,"breadcrumbs":4,"title":2},"57":{"body":27,"breadcrumbs":4,"title":2},"58":{"body":30,"breadcrumbs":4,"title":2},"59":{"body":7,"breadcrumbs":5,"title":3},"6":{"body":25,"breadcrumbs":3,"title":2},"60":{"body":22,"breadcrumbs":4,"title":2},"61":{"body":20,"breadcrumbs":5,"title":3},"62":{"body":6,"breadcrumbs":4,"title":2},"63":{"body":23,"breadcrumbs":4,"title":2},"64":{"body":19,"breadcrumbs":4,"title":2},"65":{"body":19,"breadcrumbs":4,"title":2},"66":{"body":28,"breadcrumbs":4,"title":2},"67":{"body":17,"breadcrumbs":5,"title":3},"68":{"body":7,"breadcrumbs":4,"title":2},"69":{"body":16,"breadcrumbs":5,"title":3},"7":{"body":4,"breadcrumbs":3,"title":2},"70":{"body":15,"breadcrumbs":4,"title":2},"71":{"body":16,"breadcrumbs":5,"title":3},"72":{"body":28,"breadcrumbs":5,"title":3},"73":{"body":3,"breadcrumbs":5,"title":3},"74":{"body":33,"breadcrumbs":4,"title":2},"75":{"body":50,"breadcrumbs":5,"title":3},"76":{"body":66,"breadcrumbs":4,"title":2},"77":{"body":3,"breadcrumbs":5,"title":3},"78":{"body":38,"breadcrumbs":4,"title":2},"79":{"body":46,"breadcrumbs":5,"title":3},"8":{"body":13,"breadcrumbs":3,"title":2},"80":{"body":61,"breadcrumbs":4,"title":2},"81":{"body":7,"breadcrumbs":4,"title":2},"82":{"body":19,"breadcrumbs":5,"title":3},"83":{"body":10,"breadcrumbs":5,"title":3},"84":{"body":20,"breadcrumbs":5,"title":3},"85":{"body":108,"breadcrumbs":5,"title":3},"86":{"body":216,"breadcrumbs":7,"title":5},"87":{"body":27,"breadcrumbs":4,"title":2},"88":{"body":29,"breadcrumbs":4,"title":2},"89":{"body":30,"breadcrumbs":4,"title":2},"9":{"body":10,"breadcrumbs":2,"title":1},"90":{"body":42,"breadcrumbs":3,"title":1},"91":{"body":0,"breadcrumbs":2,"title":1},"92":{"body":0,"breadcrumbs":4,"title":2},"93":{"body":0,"breadcrumbs":4,"title":2},"94":{"body":0,"breadcrumbs":4,"title":2},"95":{"body":0,"breadcrumbs":6,"title":3},"96":{"body":0,"breadcrumbs":6,"title":3},"97":{"body":0,"breadcrumbs":2,"title":1},"98":{"body":19,"breadcrumbs":3,"title":2},"99":{"body":14,"breadcrumbs":2,"title":1}},"docs":{"0":{"body":"Welcome to the JSON Agent Communication Standard (JACS) documentation! JACS is a comprehensive framework for creating, signing, and verifying JSON documents with cryptographic integrity, designed specifically for AI agent communication and task management.","breadcrumbs":"Introduction » JACS: JSON Agent Communication Standard","id":"0","title":"JACS: JSON Agent Communication Standard"},"1":{"body":"JACS provides a standard way for AI agents to: Create and sign JSON documents with cryptographic signatures Verify authenticity and integrity of documents Manage tasks and agreements between multiple agents Maintain audit trails of modifications and versioning Ensure trust in multi-agent systems As a developer, JACS gives you the tools to build trustworthy AI systems where agents can securely exchange tasks, agreements, and data with verifiable integrity.","breadcrumbs":"Introduction » What is JACS?","id":"1","title":"What is JACS?"},"10":{"body":"pip install jacs import jacs\nagent = jacs.Agent(\"./config.json\")","breadcrumbs":"Introduction » Python","id":"10","title":"Python"},"100":{"body":"","breadcrumbs":"Installation » Installation","id":"100","title":"Installation"},"101":{"body":"npm install jacsnpm","breadcrumbs":"Installation » Using npm","id":"101","title":"Using npm"},"102":{"body":"yarn add jacsnpm","breadcrumbs":"Installation » Using yarn","id":"102","title":"Using yarn"},"103":{"body":"pnpm add jacsnpm","breadcrumbs":"Installation » Using pnpm","id":"103","title":"Using pnpm"},"104":{"body":"Create a simple test to verify everything is working: // test.js\nimport { JacsAgent } from 'jacsnpm'; console.log('JACS Node.js bindings loaded successfully!'); // Test basic functionality\ntry { const config = { jacs_data_directory: \"./test_data\", jacs_key_directory: \"./test_keys\", jacs_default_storage: \"fs\", jacs_agent_key_algorithm: \"Ed25519\" }; const agent = new JacsAgent(config); console.log('Agent created successfully!');\n} catch (error) { console.error('Error creating agent:', error);\n} Run the test: node test.js","breadcrumbs":"Installation » Verify Installation","id":"104","title":"Verify Installation"},"105":{"body":"The jacsnpm package includes several modules:","breadcrumbs":"Installation » Package Structure","id":"105","title":"Package Structure"},"106":{"body":"import { JacsAgent, JacsConfig, JacsDocument, JacsError\n} from 'jacsnpm';","breadcrumbs":"Installation » Core Module (jacsnpm)","id":"106","title":"Core Module (jacsnpm)"},"107":{"body":"import { JacsMcpServer, createJacsMiddleware } from 'jacsnpm/mcp';","breadcrumbs":"Installation » MCP Integration (jacsnpm/mcp)","id":"107","title":"MCP Integration (jacsnpm/mcp)"},"108":{"body":"import { JacsHttpServer, createJacsRouter } from 'jacsnpm/http';","breadcrumbs":"Installation » HTTP Server (jacsnpm/http)","id":"108","title":"HTTP Server (jacsnpm/http)"},"109":{"body":"The package includes full TypeScript definitions: import { JacsAgent, JacsConfig, AgentDocument, TaskDocument, AgreementDocument } from 'jacsnpm'; interface MyConfig extends JacsConfig { custom_field?: string;\n} const config: MyConfig = { jacs_data_directory: \"./data\", jacs_key_directory: \"./keys\", jacs_default_storage: \"fs\", jacs_agent_key_algorithm: \"Ed25519\", custom_field: \"value\"\n}; const agent: JacsAgent = new JacsAgent(config);","breadcrumbs":"Installation » TypeScript Support","id":"109","title":"TypeScript Support"},"11":{"body":"JACS is ideal for scenarios where you need: Multi-agent systems where agents need to trust each other Task delegation with verifiable completion and approval Audit trails for AI decision-making processes Secure data exchange between AI systems Compliance requirements for AI system interactions Version control for AI-generated content and decisions","breadcrumbs":"Introduction » When to Use JACS","id":"11","title":"When to Use JACS"},"110":{"body":"","breadcrumbs":"Installation » Configuration","id":"110","title":"Configuration"},"111":{"body":"const config = { // Required fields jacs_data_directory: \"./jacs_data\", // Where documents are stored jacs_key_directory: \"./jacs_keys\", // Where keys are stored jacs_default_storage: \"fs\", // Storage backend jacs_agent_key_algorithm: \"Ed25519\", // Signing algorithm // Optional fields jacs_agent_id_and_version: null, // Existing agent to load jacs_agent_private_key_filename: \"private.pem\", jacs_agent_public_key_filename: \"public.pem\"\n};","breadcrumbs":"Installation » Basic Configuration","id":"111","title":"Basic Configuration"},"112":{"body":"You can also use a JSON configuration file: { \"jacs_data_directory\": \"./jacs_data\", \"jacs_key_directory\": \"./jacs_keys\", \"jacs_default_storage\": \"fs\", \"jacs_agent_key_algorithm\": \"Ed25519\"\n} Load the configuration: import fs from 'fs'; const config = JSON.parse(fs.readFileSync('./jacs.config.json', 'utf8'));\nconst agent = new JacsAgent(config);","breadcrumbs":"Installation » Configuration File","id":"112","title":"Configuration File"},"113":{"body":"You can override configuration with environment variables: export JACS_DATA_DIRECTORY=\"./production_data\"\nexport JACS_KEY_DIRECTORY=\"./production_keys\"\nexport JACS_AGENT_KEY_ALGORITHM=\"RSA\" const config = { jacs_data_directory: process.env.JACS_DATA_DIRECTORY || \"./jacs_data\", jacs_key_directory: process.env.JACS_KEY_DIRECTORY || \"./jacs_keys\", jacs_default_storage: \"fs\", jacs_agent_key_algorithm: process.env.JACS_AGENT_KEY_ALGORITHM || \"Ed25519\"\n};","breadcrumbs":"Installation » Environment Variables","id":"113","title":"Environment Variables"},"114":{"body":"","breadcrumbs":"Installation » Storage Backends","id":"114","title":"Storage Backends"},"115":{"body":"const config = { jacs_default_storage: \"fs\", jacs_data_directory: \"./jacs_data\", jacs_key_directory: \"./jacs_keys\"\n};","breadcrumbs":"Installation » File System (Default)","id":"115","title":"File System (Default)"},"116":{"body":"const config = { jacs_default_storage: \"s3\", jacs_s3_bucket: \"my-jacs-bucket\", jacs_s3_region: \"us-west-2\", jacs_s3_prefix: \"jacs/\"\n};","breadcrumbs":"Installation » S3 Storage","id":"116","title":"S3 Storage"},"117":{"body":"const config = { jacs_default_storage: \"azure\", jacs_azure_account: \"myaccount\", jacs_azure_container: \"jacs\", jacs_azure_key: process.env.AZURE_STORAGE_KEY\n};","breadcrumbs":"Installation » Azure Blob Storage","id":"117","title":"Azure Blob Storage"},"118":{"body":"","breadcrumbs":"Installation » Cryptographic Algorithms","id":"118","title":"Cryptographic Algorithms"},"119":{"body":"const config = { jacs_agent_key_algorithm: \"Ed25519\"\n}; Pros : Fast, secure, small signatures Cons : Newer standard, less universal support","breadcrumbs":"Installation » Ed25519 (Recommended)","id":"119","title":"Ed25519 (Recommended)"},"12":{"body":"","breadcrumbs":"Introduction » Why JACS?","id":"12","title":"Why JACS?"},"120":{"body":"const config = { jacs_agent_key_algorithm: \"RSA\"\n}; Pros : Widely supported, proven security Cons : Larger signatures, slower","breadcrumbs":"Installation » RSA-PSS","id":"120","title":"RSA-PSS"},"121":{"body":"const config = { jacs_agent_key_algorithm: \"Dilithium\"\n}; Pros : Quantum-resistant Cons : Experimental, large signatures","breadcrumbs":"Installation » Post-Quantum (Experimental)","id":"121","title":"Post-Quantum (Experimental)"},"122":{"body":"","breadcrumbs":"Installation » Development Setup","id":"122","title":"Development Setup"},"123":{"body":"my-jacs-project/\n├── package.json\n├── jacs.config.json\n├── src/\n│ ├── agent.js\n│ ├── tasks.js\n│ └── agreements.js\n├── jacs_data/\n│ ├── agents/\n│ ├── tasks/\n│ └── documents/\n└── jacs_keys/ ├── private.pem └── public.pem","breadcrumbs":"Installation » Project Structure","id":"123","title":"Project Structure"},"124":{"body":"{ \"name\": \"my-jacs-app\", \"version\": \"1.0.0\", \"type\": \"module\", \"dependencies\": { \"jacsnpm\": \"^0.1.0\", \"express\": \"^4.18.0\" }, \"scripts\": { \"start\": \"node src/app.js\", \"test\": \"node test/test.js\", \"dev\": \"nodemon src/app.js\" }\n}","breadcrumbs":"Installation » Package.json Setup","id":"124","title":"Package.json Setup"},"125":{"body":"// src/app.js\nimport { JacsAgent } from 'jacsnpm';\nimport fs from 'fs'; // Load configuration\nconst config = JSON.parse(fs.readFileSync('./jacs.config.json', 'utf8')); // Create agent\nconst agent = new JacsAgent(config); // Initialize if needed\nif (!config.jacs_agent_id_and_version) { await agent.generateKeys(); const agentDoc = await agent.createAgent({ name: \"My JACS Agent\", description: \"Example Node.js JACS agent\" }); // Update config with agent ID config.jacs_agent_id_and_version = `${agentDoc.jacsId}:${agentDoc.jacsVersion}`; fs.writeFileSync('./jacs.config.json', JSON.stringify(config, null, 2));\n} console.log('JACS agent ready!');","breadcrumbs":"Installation » Basic Application","id":"125","title":"Basic Application"},"126":{"body":"","breadcrumbs":"Installation » Common Issues","id":"126","title":"Common Issues"},"127":{"body":"If you get Module not found errors: # Check Node.js version\nnode --version # Should be 16+ # Clear node_modules and reinstall\nrm -rf node_modules package-lock.json\nnpm install","breadcrumbs":"Installation » Module Not Found","id":"127","title":"Module Not Found"},"128":{"body":"If you get permission errors accessing files: # Check directory permissions\nls -la jacs_data/ jacs_keys/ # Fix permissions\nchmod 755 jacs_data/ jacs_keys/\nchmod 600 jacs_keys/*.pem","breadcrumbs":"Installation » Permission Errors","id":"128","title":"Permission Errors"},"129":{"body":"If you get binary compatibility errors: # Rebuild native modules\nnpm rebuild # Or reinstall\nnpm uninstall jacsnpm\nnpm install jacsnpm","breadcrumbs":"Installation » Binary Compatibility","id":"129","title":"Binary Compatibility"},"13":{"body":"Unlike general-purpose signing frameworks, JACS is specifically designed for AI agent communication patterns - tasks, agreements, and collaborative workflows.","breadcrumbs":"Introduction » 🎯 Agent-Focused Design","id":"13","title":"🎯 Agent-Focused Design"},"130":{"body":"If TypeScript can't find definitions: // tsconfig.json\n{ \"compilerOptions\": { \"moduleResolution\": \"node\", \"esModuleInterop\": true, \"allowSyntheticDefaultImports\": true }\n}","breadcrumbs":"Installation » TypeScript Issues","id":"130","title":"TypeScript Issues"},"131":{"body":"Now that you have JACS installed: Basic Usage - Learn core JACS operations MCP Integration - Add Model Context Protocol support HTTP Server - Create JACS HTTP APIs Express Middleware - Integrate with Express.js API Reference - Complete API documentation","breadcrumbs":"Installation » Next Steps","id":"131","title":"Next Steps"},"132":{"body":"Check out the complete examples in the examples directory : Basic agent creation and task management Express.js middleware integration MCP server implementation","breadcrumbs":"Installation » Examples","id":"132","title":"Examples"},"133":{"body":"","breadcrumbs":"Basic Usage » Basic Usage","id":"133","title":"Basic Usage"},"134":{"body":"JACS provides native integration with the Model Context Protocol (MCP) , enabling secure agent communication within AI systems. This allows JACS agents to be used directly as MCP servers or clients.","breadcrumbs":"MCP Integration » Model Context Protocol (MCP) Integration","id":"134","title":"Model Context Protocol (MCP) Integration"},"135":{"body":"Model Context Protocol is a standard for AI models to securely access external tools, data, and services. JACS enhances MCP by adding: Cryptographic verification of tool outputs Agent identity for all operations Audit trails of all MCP interactions Multi-agent agreements for complex workflows","breadcrumbs":"MCP Integration » What is MCP?","id":"135","title":"What is MCP?"},"136":{"body":"","breadcrumbs":"MCP Integration » Quick Start","id":"136","title":"Quick Start"},"137":{"body":"import { JacsMcpServer } from 'jacsnpm/mcp'; // Create a JACS-enabled MCP server\nconst server = new JacsMcpServer({ name: \"JACS Task Server\", version: \"1.0.0\", configPath: './jacs.config.json'\n}); // Add JACS tools automatically\nserver.addJacsTools(); // Start the server\nawait server.start();\nconsole.log('JACS MCP Server running!');","breadcrumbs":"MCP Integration » Basic MCP Server","id":"137","title":"Basic MCP Server"},"138":{"body":"import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { createJacsMiddleware } from 'jacsnpm/mcp'; const server = new McpServer({ name: \"MyServer\", version: \"1.0.0\" }); // Add JACS middleware\nserver.use(createJacsMiddleware({ configPath: './jacs.config.json' })); await server.start();","breadcrumbs":"MCP Integration » Using with Existing MCP Server","id":"138","title":"Using with Existing MCP Server"},"139":{"body":"When you add JACS to an MCP server, it provides these tools:","breadcrumbs":"MCP Integration » Available Tools","id":"139","title":"Available Tools"},"14":{"body":"With built-in observability, multiple storage backends, and comprehensive error handling, JACS is ready for production AI systems.","breadcrumbs":"Introduction » 🚀 Production Ready","id":"14","title":"🚀 Production Ready"},"140":{"body":"jacs_create_agent - Create new JACS agents jacs_update_agent - Update agent information jacs_verify_agent - Verify agent signatures jacs_list_agents - List all known agents","breadcrumbs":"MCP Integration » Agent Management","id":"140","title":"Agent Management"},"141":{"body":"jacs_create_task - Create signed task documents jacs_assign_task - Delegate tasks to other agents jacs_complete_task - Mark tasks as completed jacs_verify_task - Verify task signatures","breadcrumbs":"MCP Integration » Task Management","id":"141","title":"Task Management"},"142":{"body":"jacs_create_agreement - Create multi-party agreements jacs_sign_agreement - Add signature to agreement jacs_verify_agreement - Check agreement completeness jacs_list_agreements - Show pending/completed agreements","breadcrumbs":"MCP Integration » Agreement Management","id":"142","title":"Agreement Management"},"143":{"body":"jacs_create_document - Create and sign any document jacs_verify_document - Verify document integrity jacs_list_documents - List all documents jacs_get_document - Retrieve specific document","breadcrumbs":"MCP Integration » Document Operations","id":"143","title":"Document Operations"},"144":{"body":"","breadcrumbs":"MCP Integration » Configuration","id":"144","title":"Configuration"},"145":{"body":"const serverConfig = { // MCP Server settings name: \"JACS Agent Server\", version: \"1.0.0\", // JACS Configuration configPath: './jacs.config.json', // Optional: Custom tools enabledTools: [ 'jacs_create_task', 'jacs_verify_task', 'jacs_create_agreement', 'jacs_sign_agreement' ], // Optional: Auto-initialization autoInit: true, createAgentOnInit: true\n}; const server = new JacsMcpServer(serverConfig);","breadcrumbs":"MCP Integration » Server Configuration","id":"145","title":"Server Configuration"},"146":{"body":"const middlewareConfig = { configPath: './jacs.config.json', // Agent initialization autoCreateAgent: true, agentName: \"MCP JACS Agent\", agentDescription: \"Agent providing JACS services via MCP\", // Tool selection tools: ['tasks', 'agreements', 'documents'], // Security options requireSignatures: true, verifyIncomingDocuments: true\n}; server.use(createJacsMiddleware(middlewareConfig));","breadcrumbs":"MCP Integration » Middleware Configuration","id":"146","title":"Middleware Configuration"},"147":{"body":"","breadcrumbs":"MCP Integration » Tool Usage Examples","id":"147","title":"Tool Usage Examples"},"148":{"body":"// MCP Client code (Claude, other AI systems)\nconst taskResult = await mcpClient.callTool('jacs_create_task', { title: \"Analyze Sales Data\", description: \"Generate insights from Q4 sales data\", actions: [ { id: \"extract\", name: \"Extract Data\", description: \"Pull sales data from database\", success: \"Complete dataset extracted\", failure: \"Unable to connect to database\" }, { id: \"analyze\", name: \"Analyze Trends\", description: \"Identify patterns and insights\", success: \"Key insights identified\", failure: \"Insufficient data for analysis\" } ]\n}); console.log('Task created:', taskResult.jacsId);\nconsole.log('Task signature:', taskResult.jacsSignature);","breadcrumbs":"MCP Integration » Creating a Task","id":"148","title":"Creating a Task"},"149":{"body":"const agreementResult = await mcpClient.callTool('jacs_create_agreement', { title: \"Data Analysis Agreement\", question: \"Do you agree to analyze the Q4 sales data?\", context: \"Task requires access to confidential sales database\", agents: [ \"agent-1-uuid\", \"agent-2-uuid\", \"agent-3-uuid\" ]\n}); console.log('Agreement created:', agreementResult.jacsId);\nconsole.log('Required signatures:', agreementResult.agents.length);","breadcrumbs":"MCP Integration » Creating an Agreement","id":"149","title":"Creating an Agreement"},"15":{"body":"Support for both current (RSA, Ed25519) and post-quantum cryptographic algorithms ensures your system remains secure.","breadcrumbs":"Introduction » 🔒 Future-Proof Security","id":"15","title":"🔒 Future-Proof Security"},"150":{"body":"const verificationResult = await mcpClient.callTool('jacs_verify_document', { documentId: \"task-uuid-here\"\n}); console.log('Document valid:', verificationResult.valid);\nconsole.log('Signature verified:', verificationResult.signatureValid);\nconsole.log('Hash verified:', verificationResult.hashValid);","breadcrumbs":"MCP Integration » Verifying Documents","id":"150","title":"Verifying Documents"},"151":{"body":"","breadcrumbs":"MCP Integration » Advanced Integration","id":"151","title":"Advanced Integration"},"152":{"body":"Add your own JACS-aware tools: import { JacsMcpServer } from 'jacsnpm/mcp'; const server = new JacsMcpServer(config); // Custom tool that creates signed reports\nserver.addTool({ name: \"create_signed_report\", description: \"Create a cryptographically signed report\", inputSchema: { type: \"object\", properties: { title: { type: \"string\" }, content: { type: \"string\" }, reportType: { type: \"string\", enum: [\"analysis\", \"summary\", \"recommendation\"] } }, required: [\"title\", \"content\", \"reportType\"] }\n}, async (params) => { const { title, content, reportType } = params; // Create report document const report = { jacsType: \"report\", title, content, reportType, generatedAt: new Date().toISOString() }; // Sign with JACS agent const signedReport = await server.jacsAgent.createDocument(report); return { success: true, document: signedReport, verification: await server.jacsAgent.verifyDocument(signedReport) };\n});","breadcrumbs":"MCP Integration » Custom Tools","id":"152","title":"Custom Tools"},"153":{"body":"Coordinate multiple agents through MCP: // Agent A creates a task\nconst task = await agentA.callTool('jacs_create_task', { title: \"Content Creation Pipeline\", description: \"Multi-stage content creation process\"\n}); // Create agreement for collaboration\nconst agreement = await agentA.callTool('jacs_create_agreement', { title: \"Content Collaboration Agreement\", question: \"Do you agree to participate in content creation?\", context: `Task: ${task.jacsId}`, agents: [agentA.id, agentB.id, agentC.id]\n}); // Each agent signs the agreement\nawait agentA.callTool('jacs_sign_agreement', { agreementId: agreement.jacsId });\nawait agentB.callTool('jacs_sign_agreement', { agreementId: agreement.jacsId });\nawait agentC.callTool('jacs_sign_agreement', { agreementId: agreement.jacsId }); // Verify all signatures before proceeding\nconst verification = await agentA.callTool('jacs_verify_agreement', { agreementId: agreement.jacsId }); if (verification.complete) { console.log('All agents have signed - workflow can proceed');\n}","breadcrumbs":"MCP Integration » Multi-Agent Workflows","id":"153","title":"Multi-Agent Workflows"},"154":{"body":"","breadcrumbs":"MCP Integration » Transport Options","id":"154","title":"Transport Options"},"155":{"body":"import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'; const server = new JacsMcpServer(config);\nconst transport = new StdioServerTransport();\nawait server.connect(transport);","breadcrumbs":"MCP Integration » Stdio Transport (Default)","id":"155","title":"Stdio Transport (Default)"},"156":{"body":"import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js'; const server = new JacsMcpServer(config);\nconst transport = new SSEServerTransport('/mcp', { port: 3000\n});\nawait server.connect(transport);","breadcrumbs":"MCP Integration » SSE Transport (HTTP)","id":"156","title":"SSE Transport (HTTP)"},"157":{"body":"import { WebSocketServerTransport } from '@modelcontextprotocol/sdk/server/websocket.js'; const server = new JacsMcpServer(config);\nconst transport = new WebSocketServerTransport({ port: 3001\n});\nawait server.connect(transport);","breadcrumbs":"MCP Integration » WebSocket Transport","id":"157","title":"WebSocket Transport"},"158":{"body":"","breadcrumbs":"MCP Integration » Client Integration","id":"158","title":"Client Integration"},"159":{"body":"import { Client } from '@modelcontextprotocol/sdk/client/index.js';\nimport { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js'; // Connect to JACS MCP server\nconst transport = new StdioClientTransport({ command: 'node', args: ['jacs-mcp-server.js']\n}); const client = new Client({ name: \"JACS MCP Client\", version: \"1.0.0\"\n}, { capabilities: { tools: {} }\n}); await client.connect(transport); // List available JACS tools\nconst tools = await client.listTools();\nconsole.log('Available JACS tools:', tools.tools.map(t => t.name)); // Use JACS tools\nconst result = await client.callTool({ name: \"jacs_create_task\", arguments: { title: \"Example Task\", description: \"Task created via MCP client\" }\n}); console.log('Task created:', result.content);","breadcrumbs":"MCP Integration » Using JACS with MCP Clients","id":"159","title":"Using JACS with MCP Clients"},"16":{"body":"JSON-based documents work everywhere - store them in any database, transmit over any protocol, integrate with any system.","breadcrumbs":"Introduction » 🌐 Universal Compatibility","id":"16","title":"🌐 Universal Compatibility"},"160":{"body":"","breadcrumbs":"MCP Integration » Security Considerations","id":"160","title":"Security Considerations"},"161":{"body":"All JACS tools automatically verify signatures: // Tool implementation with verification\nserver.addTool({ name: \"process_task_result\", description: \"Process results from task completion\"\n}, async (params) => { const { taskId, result } = params; // Verify the task exists and signature is valid const task = await server.jacsAgent.getDocument(taskId); const isValid = await server.jacsAgent.verifyDocument(task); if (!isValid) { throw new Error('Invalid task signature - refusing to process'); } // Process the verified task result return processResult(result);\n});","breadcrumbs":"MCP Integration » Signature Verification","id":"161","title":"Signature Verification"},"162":{"body":"Authenticate agent identity for sensitive operations: server.addTool({ name: \"access_sensitive_data\", description: \"Access sensitive data with agent verification\"\n}, async (params, context) => { const { agentId, dataType } = params; // Verify the requesting agent has proper credentials const agent = await server.jacsAgent.getAgent(agentId); const hasPermission = await checkAgentPermissions(agent, dataType); if (!hasPermission) { throw new Error('Agent lacks permission for this data type'); } return getSensitiveData(dataType);\n});","breadcrumbs":"MCP Integration » Agent Authentication","id":"162","title":"Agent Authentication"},"163":{"body":"","breadcrumbs":"MCP Integration » Monitoring and Observability","id":"163","title":"Monitoring and Observability"},"164":{"body":"const server = new JacsMcpServer({ ...config, logging: { logRequests: true, logSignatures: true, logVerifications: true }\n}); // Logs will include:\n// - Tool calls with agent identity\n// - Signature verification results // - Document creation/modification\n// - Agreement signing events","breadcrumbs":"MCP Integration » Request Logging","id":"164","title":"Request Logging"},"165":{"body":"import { recordMcpOperation } from 'jacsnpm/observability'; server.addTool({ name: \"example_tool\"\n}, async (params) => { const startTime = Date.now(); try { const result = await performOperation(params); recordMcpOperation('example_tool', true, Date.now() - startTime); return result; } catch (error) { recordMcpOperation('example_tool', false, Date.now() - startTime); throw error; }\n});","breadcrumbs":"MCP Integration » Metrics Collection","id":"165","title":"Metrics Collection"},"166":{"body":"Complete MCP integration examples are available: Basic MCP Server - Simple JACS MCP server Express Integration - MCP server with Express.js Multi-Agent Workflow - Coordinated agent collaboration Custom Tools - Building domain-specific JACS tools","breadcrumbs":"MCP Integration » Examples","id":"166","title":"Examples"},"167":{"body":"","breadcrumbs":"MCP Integration » Troubleshooting","id":"167","title":"Troubleshooting"},"168":{"body":"# Test MCP server connectivity\necho '{\"jsonrpc\": \"2.0\", \"id\": 1, \"method\": \"initialize\", \"params\": {\"protocolVersion\": \"2024-11-05\", \"capabilities\": {}}}' | node jacs-mcp-server.js","breadcrumbs":"MCP Integration » Connection Issues","id":"168","title":"Connection Issues"},"169":{"body":"// Verify tools are registered correctly\nconst server = new JacsMcpServer(config);\nawait server.start(); const tools = await server.listTools();\nconsole.log('Registered tools:', tools.map(t => t.name));","breadcrumbs":"MCP Integration » Tool Registration Problems","id":"169","title":"Tool Registration Problems"},"17":{"body":"Whether you're building a simple CLI tool or a complex multi-agent system, JACS adapts to your architecture.","breadcrumbs":"Introduction » 🧩 Flexible Integration","id":"17","title":"🧩 Flexible Integration"},"170":{"body":"// Debug signature issues\ntry { const result = await mcpClient.callTool('jacs_verify_document', { documentId: 'problematic-doc-id' });\n} catch (error) { console.error('Verification details:', error.details); // Check agent keys, document integrity, etc.\n} For more details, see the API Reference and complete examples .","breadcrumbs":"MCP Integration » Signature Verification Failures","id":"170","title":"Signature Verification Failures"},"171":{"body":"","breadcrumbs":"HTTP Server » HTTP Server","id":"171","title":"HTTP Server"},"172":{"body":"","breadcrumbs":"Express Middleware » Express Middleware","id":"172","title":"Express Middleware"},"173":{"body":"","breadcrumbs":"API Reference » API Reference","id":"173","title":"API Reference"},"174":{"body":"The JACS Python package (jacs) provides Python bindings to the JACS Rust library, making it easy to integrate JACS into AI/ML workflows, data science projects, and Python applications.","breadcrumbs":"Installation » Python Installation","id":"174","title":"Python Installation"},"175":{"body":"Python : Version 3.10 or higher pip : For package management Operating System : Linux, macOS, or Windows with WSL Architecture : x86_64 or ARM64","breadcrumbs":"Installation » Requirements","id":"175","title":"Requirements"},"176":{"body":"","breadcrumbs":"Installation » Installation","id":"176","title":"Installation"},"177":{"body":"pip install jacs","breadcrumbs":"Installation » Using pip","id":"177","title":"Using pip"},"178":{"body":"conda install -c conda-forge jacs","breadcrumbs":"Installation » Using conda","id":"178","title":"Using conda"},"179":{"body":"poetry add jacs","breadcrumbs":"Installation » Using poetry","id":"179","title":"Using poetry"},"18":{"body":"Core Concepts - Understand agents, documents, and agreements Quick Start Guide - Get up and running in minutes Choose Your Implementation : Rust CLI & Library Node.js Package Python Package","breadcrumbs":"Introduction » Getting Started","id":"18","title":"Getting Started"},"180":{"body":"# Clone the repository\ngit clone https://github.com/HumanAssisted/JACS\ncd JACS/jacspy # Create virtual environment\npython -m venv .venv\nsource .venv/bin/activate # On Windows: .venv\\Scripts\\activate # Install in development mode\npip install -e .","breadcrumbs":"Installation » Development Installation","id":"180","title":"Development Installation"},"181":{"body":"Create a simple test to verify everything is working: # test.py\nimport jacs\nimport json print('JACS Python bindings loaded successfully!') # Test basic functionality\ntry: config = { \"jacs_data_directory\": \"./test_data\", \"jacs_key_directory\": \"./test_keys\", \"jacs_default_storage\": \"fs\", \"jacs_agent_key_algorithm\": \"Ed25519\" } agent = jacs.Agent(config) print('Agent created successfully!')\nexcept Exception as error: print(f'Error creating agent: {error}') Run the test: python test.py","breadcrumbs":"Installation » Verify Installation","id":"181","title":"Verify Installation"},"182":{"body":"The jacs package includes several modules:","breadcrumbs":"Installation » Package Structure","id":"182","title":"Package Structure"},"183":{"body":"import jacs # Core classes\nagent = jacs.Agent(config)\ndocument = jacs.Document(data)\ntask = jacs.Task(config)","breadcrumbs":"Installation » Core Module","id":"183","title":"Core Module"},"184":{"body":"from jacs.mcp import JacsMcpServer, create_jacs_middleware # MCP server functionality\nserver = JacsMcpServer(config)","breadcrumbs":"Installation » MCP Integration","id":"184","title":"MCP Integration"},"185":{"body":"from jacs.fastmcp import FastMcpServer, JacsTools # Advanced MCP server with FastMCP\nserver = FastMcpServer()\nserver.add_jacs_tools()","breadcrumbs":"Installation » FastMCP Integration","id":"185","title":"FastMCP Integration"},"186":{"body":"","breadcrumbs":"Installation » Configuration","id":"186","title":"Configuration"},"187":{"body":"config = { # Required fields \"jacs_data_directory\": \"./jacs_data\", # Where documents are stored \"jacs_key_directory\": \"./jacs_keys\", # Where keys are stored \"jacs_default_storage\": \"fs\", # Storage backend \"jacs_agent_key_algorithm\": \"Ed25519\", # Signing algorithm # Optional fields \"jacs_agent_id_and_version\": None, # Existing agent to load \"jacs_agent_private_key_filename\": \"private.pem\", \"jacs_agent_public_key_filename\": \"public.pem\"\n}","breadcrumbs":"Installation » Basic Configuration","id":"187","title":"Basic Configuration"},"188":{"body":"You can also use a JSON configuration file: { \"jacs_data_directory\": \"./jacs_data\", \"jacs_key_directory\": \"./jacs_keys\", \"jacs_default_storage\": \"fs\", \"jacs_agent_key_algorithm\": \"Ed25519\"\n} Load the configuration: import json with open('jacs.config.json', 'r') as f: config = json.load(f) agent = jacs.Agent(config)","breadcrumbs":"Installation » Configuration File","id":"188","title":"Configuration File"},"189":{"body":"You can override configuration with environment variables: export JACS_DATA_DIRECTORY=\"./production_data\"\nexport JACS_KEY_DIRECTORY=\"./production_keys\"\nexport JACS_AGENT_KEY_ALGORITHM=\"RSA\" import os config = { \"jacs_data_directory\": os.getenv(\"JACS_DATA_DIRECTORY\", \"./jacs_data\"), \"jacs_key_directory\": os.getenv(\"JACS_KEY_DIRECTORY\", \"./jacs_keys\"), \"jacs_default_storage\": \"fs\", \"jacs_agent_key_algorithm\": os.getenv(\"JACS_AGENT_KEY_ALGORITHM\", \"Ed25519\")\n}","breadcrumbs":"Installation » Environment Variables","id":"189","title":"Environment Variables"},"19":{"body":"GitHub : HumanAssisted/JACS Issues : Report bugs and feature requests Examples : Complete examples for all implementations Documentation : This comprehensive guide Ready to build trustworthy AI systems? Let's get started!","breadcrumbs":"Introduction » Community and Support","id":"19","title":"Community and Support"},"190":{"body":"","breadcrumbs":"Installation » Storage Backends","id":"190","title":"Storage Backends"},"191":{"body":"config = { \"jacs_default_storage\": \"fs\", \"jacs_data_directory\": \"./jacs_data\", \"jacs_key_directory\": \"./jacs_keys\"\n}","breadcrumbs":"Installation » File System (Default)","id":"191","title":"File System (Default)"},"192":{"body":"config = { \"jacs_default_storage\": \"s3\", \"jacs_s3_bucket\": \"my-jacs-bucket\", \"jacs_s3_region\": \"us-west-2\", \"jacs_s3_prefix\": \"jacs/\"\n}","breadcrumbs":"Installation » S3 Storage","id":"192","title":"S3 Storage"},"193":{"body":"config = { \"jacs_default_storage\": \"azure\", \"jacs_azure_account\": \"myaccount\", \"jacs_azure_container\": \"jacs\", \"jacs_azure_key\": os.getenv(\"AZURE_STORAGE_KEY\")\n}","breadcrumbs":"Installation » Azure Blob Storage","id":"193","title":"Azure Blob Storage"},"194":{"body":"","breadcrumbs":"Installation » Cryptographic Algorithms","id":"194","title":"Cryptographic Algorithms"},"195":{"body":"config = { \"jacs_agent_key_algorithm\": \"Ed25519\"\n} Pros : Fast, secure, small signatures Cons : Newer standard, less universal support","breadcrumbs":"Installation » Ed25519 (Recommended)","id":"195","title":"Ed25519 (Recommended)"},"196":{"body":"config = { \"jacs_agent_key_algorithm\": \"RSA\"\n} Pros : Widely supported, proven security Cons : Larger signatures, slower","breadcrumbs":"Installation » RSA-PSS","id":"196","title":"RSA-PSS"},"197":{"body":"config = { \"jacs_agent_key_algorithm\": \"Dilithium\"\n} Pros : Quantum-resistant Cons : Experimental, large signatures","breadcrumbs":"Installation » Post-Quantum (Experimental)","id":"197","title":"Post-Quantum (Experimental)"},"198":{"body":"","breadcrumbs":"Installation » Development Setup","id":"198","title":"Development Setup"},"199":{"body":"my-jacs-project/\n├── requirements.txt\n├── jacs.config.json\n├── src/\n│ ├── agent.py\n│ ├── tasks.py\n│ └── agreements.py\n├── jacs_data/\n│ ├── agents/\n│ ├── tasks/\n│ └── documents/\n├── jacs_keys/\n│ ├── private.pem\n│ └── public.pem\n└── tests/ └── test_jacs.py","breadcrumbs":"Installation » Project Structure","id":"199","title":"Project Structure"},"2":{"body":"🔐 Cryptographic Security : RSA, Ed25519, and post-quantum cryptographic algorithms 📋 JSON Schema Validation : Enforced document structure and validation 🤝 Multi-Agent Agreements : Built-in support for agent collaboration and task agreements 🔍 Full Audit Trail : Complete versioning and modification history 🌐 Multiple Language Support : Rust, Node.js, and Python implementations 🔌 MCP Integration : Native Model Context Protocol support 📊 Observability : Built-in logging and metrics for production systems","breadcrumbs":"Introduction » Key Features","id":"2","title":"Key Features"},"20":{"body":"JACS (JSON Agent Communication Standard) is a comprehensive framework designed to solve a critical problem in AI systems: How do agents communicate and collaborate securely with verifiable trust?","breadcrumbs":"What is JACS? » What is JACS?","id":"20","title":"What is JACS?"},"200":{"body":"jacs>=0.1.0\nfastapi>=0.100.0 # For FastMCP integration\nuvicorn>=0.23.0 # For ASGI server\npydantic>=2.0.0 # For data validation","breadcrumbs":"Installation » Requirements.txt Setup","id":"200","title":"Requirements.txt Setup"},"201":{"body":"# src/app.py\nimport jacs\nimport json\nimport os def main(): # Load configuration with open('jacs.config.json', 'r') as f: config = json.load(f) # Create agent agent = jacs.Agent(config) # Initialize if needed if not config.get(\"jacs_agent_id_and_version\"): agent.generate_keys() agent_doc = agent.create_agent({ \"name\": \"My Python JACS Agent\", \"description\": \"Example Python JACS agent\" }) # Update config with agent ID config[\"jacs_agent_id_and_version\"] = f\"{agent_doc['jacsId']}:{agent_doc['jacsVersion']}\" with open('jacs.config.json', 'w') as f: json.dump(config, f, indent=2) print('JACS agent ready!') return agent if __name__ == \"__main__\": agent = main()","breadcrumbs":"Installation » Basic Application","id":"201","title":"Basic Application"},"202":{"body":"","breadcrumbs":"Installation » Virtual Environment Setup","id":"202","title":"Virtual Environment Setup"},"203":{"body":"# Create virtual environment\npython -m venv jacs-env # Activate (Linux/macOS)\nsource jacs-env/bin/activate # Activate (Windows)\njacs-env\\Scripts\\activate # Install JACS\npip install jacs","breadcrumbs":"Installation » Using venv","id":"203","title":"Using venv"},"204":{"body":"# Create conda environment\nconda create -n jacs-env python=3.11 # Activate environment\nconda activate jacs-env # Install JACS\npip install jacs","breadcrumbs":"Installation » Using conda","id":"204","title":"Using conda"},"205":{"body":"# Initialize poetry project\npoetry init # Add JACS dependency\npoetry add jacs # Install dependencies\npoetry install # Activate shell\npoetry shell","breadcrumbs":"Installation » Using poetry","id":"205","title":"Using poetry"},"206":{"body":"# Install Jupyter in your JACS environment\npip install jupyter # Start Jupyter\njupyter notebook # In your notebook\nimport jacs\nimport json\nimport os # Setup configuration\nconfig = { \"jacs_data_directory\": \"./notebook_data\", \"jacs_key_directory\": \"./notebook_keys\", \"jacs_default_storage\": \"fs\", \"jacs_agent_key_algorithm\": \"Ed25519\"\n} # Ensure directories exist\nos.makedirs(config[\"jacs_data_directory\"], exist_ok=True)\nos.makedirs(config[\"jacs_key_directory\"], exist_ok=True) # Create agent\nagent = jacs.Agent(config) print(\"JACS ready for notebook use!\")","breadcrumbs":"Installation » Jupyter Notebook Setup","id":"206","title":"Jupyter Notebook Setup"},"207":{"body":"","breadcrumbs":"Installation » Common Issues","id":"207","title":"Common Issues"},"208":{"body":"If you get ModuleNotFoundError: No module named 'jacs': # Check Python version\npython --version # Should be 3.10+ # Check if jacs is installed\npip list | grep jacs # Reinstall if needed\npip uninstall jacs\npip install jacs","breadcrumbs":"Installation » Module Not Found","id":"208","title":"Module Not Found"},"209":{"body":"If you get permission errors accessing files: # Check directory permissions\nls -la jacs_data/ jacs_keys/ # Fix permissions\nchmod 755 jacs_data/ jacs_keys/\nchmod 600 jacs_keys/*.pem","breadcrumbs":"Installation » Permission Errors","id":"209","title":"Permission Errors"},"21":{"body":"As AI systems become more sophisticated, we're moving toward multi-agent architectures where different AI agents need to: Exchange tasks and delegate work to each other Create agreements and verify their completion Share data with guaranteed authenticity Maintain audit trails of decisions and actions Establish trust without centralized authorities Traditional approaches fall short because they lack: Cryptographic integrity for agent communications Standardized formats for agent interactions Built-in versioning and audit trails Support for multi-agent agreements and workflows","breadcrumbs":"What is JACS? » The Problem JACS Solves","id":"21","title":"The Problem JACS Solves"},"210":{"body":"If you get binary compatibility errors: # Update pip and reinstall\npip install --upgrade pip\npip uninstall jacs\npip install jacs --no-cache-dir","breadcrumbs":"Installation » Binary Compatibility","id":"210","title":"Binary Compatibility"},"211":{"body":"On Windows, you may need Visual C++ Build Tools: # Install Visual C++ Build Tools\n# Or use conda-forge\nconda install -c conda-forge jacs","breadcrumbs":"Installation » Windows Issues","id":"211","title":"Windows Issues"},"212":{"body":"JACS includes type hints for better IDE support: from typing import Dict, List, Any\nimport jacs # Type hints work with modern IDEs\nconfig: Dict[str, Any] = { \"jacs_data_directory\": \"./data\", \"jacs_key_directory\": \"./keys\", \"jacs_default_storage\": \"fs\", \"jacs_agent_key_algorithm\": \"Ed25519\"\n} agent: jacs.Agent = jacs.Agent(config)\nagent_doc: Dict[str, Any] = agent.create_agent({ \"name\": \"Typed Agent\", \"description\": \"Agent with type hints\"\n})","breadcrumbs":"Installation » Type Hints and IDE Support","id":"212","title":"Type Hints and IDE Support"},"213":{"body":"# tests/test_jacs.py\nimport unittest\nimport tempfile\nimport os\nimport jacs class TestJACS(unittest.TestCase): def setUp(self): self.temp_dir = tempfile.mkdtemp() self.config = { \"jacs_data_directory\": os.path.join(self.temp_dir, \"data\"), \"jacs_key_directory\": os.path.join(self.temp_dir, \"keys\"), \"jacs_default_storage\": \"fs\", \"jacs_agent_key_algorithm\": \"Ed25519\" } # Create directories os.makedirs(self.config[\"jacs_data_directory\"]) os.makedirs(self.config[\"jacs_key_directory\"]) self.agent = jacs.Agent(self.config) def test_agent_creation(self): self.agent.generate_keys() agent_doc = self.agent.create_agent({ \"name\": \"Test Agent\", \"description\": \"Agent for testing\" }) self.assertIn(\"jacsId\", agent_doc) self.assertIn(\"jacsVersion\", agent_doc) self.assertIn(\"name\", agent_doc) def tearDown(self): import shutil shutil.rmtree(self.temp_dir) if __name__ == \"__main__\": unittest.main()","breadcrumbs":"Installation » Testing Setup","id":"213","title":"Testing Setup"},"214":{"body":"Now that you have JACS installed: Basic Usage - Learn core JACS operations MCP Integration - Add Model Context Protocol support FastMCP Integration - Build advanced MCP servers API Reference - Complete API documentation","breadcrumbs":"Installation » Next Steps","id":"214","title":"Next Steps"},"215":{"body":"Check out the complete examples in the examples directory : Basic agent creation and task management Jupyter notebook workflows FastMCP server implementation AI/ML pipeline integration","breadcrumbs":"Installation » Examples","id":"215","title":"Examples"},"216":{"body":"This guide covers the fundamental operations you can perform with JACS in Python, from creating agents to managing tasks and documents.","breadcrumbs":"Basic Usage » Basic Usage","id":"216","title":"Basic Usage"},"217":{"body":"Here's a complete example that demonstrates the core JACS workflow: import jacs\nimport json\nimport os # Configuration\nconfig = { \"jacs_data_directory\": \"./jacs_data\", \"jacs_key_directory\": \"./jacs_keys\", \"jacs_default_storage\": \"fs\", \"jacs_agent_key_algorithm\": \"Ed25519\"\n} # Ensure directories exist\nos.makedirs(config[\"jacs_data_directory\"], exist_ok=True)\nos.makedirs(config[\"jacs_key_directory\"], exist_ok=True) # Create agent\nagent = jacs.Agent(config) # Generate keys and create agent document\nagent.generate_keys()\nagent_doc = agent.create_agent({ \"name\": \"My Python Agent\", \"description\": \"A JACS agent for Python workflows\", \"type\": \"automation\"\n}) print(f\"Created agent: {agent_doc['name']}\")\nprint(f\"Agent ID: {agent_doc['jacsId']}\") # Create a task\ntask_doc = agent.create_task({ \"title\": \"Process Data\", \"description\": \"Analyze customer data and generate report\", \"priority\": \"high\", \"status\": \"pending\"\n}) print(f\"Created task: {task_doc['title']}\")\nprint(f\"Task ID: {task_doc['jacsId']}\") # Update task status\nupdated_task = agent.update_task(task_doc['jacsId'], { \"status\": \"in_progress\", \"progress\": 25\n}) print(f\"Updated task status: {updated_task['status']}\")","breadcrumbs":"Basic Usage » Quick Start Example","id":"217","title":"Quick Start Example"},"218":{"body":"","breadcrumbs":"Basic Usage » Agent Management","id":"218","title":"Agent Management"},"219":{"body":"import jacs # Basic agent creation\nconfig = { \"jacs_data_directory\": \"./jacs_data\", \"jacs_key_directory\": \"./jacs_keys\", \"jacs_default_storage\": \"fs\", \"jacs_agent_key_algorithm\": \"Ed25519\"\n} agent = jacs.Agent(config) # Generate cryptographic keys\nagent.generate_keys() # Create agent document\nagent_doc = agent.create_agent({ \"name\": \"Data Processor\", \"description\": \"Agent specialized in data processing tasks\", \"type\": \"data_processor\", \"capabilities\": [\"data_analysis\", \"report_generation\"], \"version\": \"1.0.0\"\n}) print(f\"Agent created with ID: {agent_doc['jacsId']}\")","breadcrumbs":"Basic Usage » Creating an Agent","id":"219","title":"Creating an Agent"},"22":{"body":"","breadcrumbs":"What is JACS? » JACS Core Philosophy","id":"22","title":"JACS Core Philosophy"},"220":{"body":"# If you have an existing agent, specify it in config\nconfig = { \"jacs_data_directory\": \"./jacs_data\", \"jacs_key_directory\": \"./jacs_keys\", \"jacs_default_storage\": \"fs\", \"jacs_agent_key_algorithm\": \"Ed25519\", \"jacs_agent_id_and_version\": \"agent_123:1\" # Load existing agent\n} agent = jacs.Agent(config) # Agent is now loaded and ready to use\nprint(\"Existing agent loaded successfully\")","breadcrumbs":"Basic Usage » Loading an Existing Agent","id":"220","title":"Loading an Existing Agent"},"221":{"body":"# Get agent information\nagent_info = agent.get_agent_info()\nprint(f\"Agent Name: {agent_info['name']}\")\nprint(f\"Agent Type: {agent_info['type']}\")\nprint(f\"Capabilities: {agent_info.get('capabilities', [])}\")","breadcrumbs":"Basic Usage » Agent Information","id":"221","title":"Agent Information"},"222":{"body":"","breadcrumbs":"Basic Usage » Task Management","id":"222","title":"Task Management"},"223":{"body":"# Simple task\ntask = agent.create_task({ \"title\": \"Data Analysis\", \"description\": \"Analyze sales data for Q4\", \"status\": \"pending\"\n}) # Detailed task with metadata\ndetailed_task = agent.create_task({ \"title\": \"Generate Monthly Report\", \"description\": \"Create comprehensive monthly performance report\", \"priority\": \"high\", \"status\": \"pending\", \"assignee\": \"data_team\", \"due_date\": \"2024-02-01\", \"tags\": [\"reporting\", \"monthly\", \"performance\"], \"metadata\": { \"department\": \"analytics\", \"report_type\": \"performance\", \"data_sources\": [\"sales\", \"marketing\", \"support\"] }\n}) print(f\"Created task: {detailed_task['jacsId']}\")","breadcrumbs":"Basic Usage » Creating Tasks","id":"223","title":"Creating Tasks"},"224":{"body":"# Update task status\nupdated_task = agent.update_task(task['jacsId'], { \"status\": \"in_progress\", \"progress\": 50, \"notes\": \"Data collection completed, starting analysis\"\n}) # Add results to completed task\ncompleted_task = agent.update_task(task['jacsId'], { \"status\": \"completed\", \"progress\": 100, \"results\": { \"total_sales\": 1250000, \"growth_rate\": 15.3, \"top_products\": [\"Product A\", \"Product B\", \"Product C\"] }, \"completion_date\": \"2024-01-15\"\n})","breadcrumbs":"Basic Usage » Updating Tasks","id":"224","title":"Updating Tasks"},"225":{"body":"# Get all tasks\nall_tasks = agent.list_tasks()\nprint(f\"Total tasks: {len(all_tasks)}\") # Filter tasks by status\npending_tasks = [task for task in all_tasks if task.get('status') == 'pending']\nprint(f\"Pending tasks: {len(pending_tasks)}\") # Get specific task\ntask_details = agent.get_task(task['jacsId'])\nprint(f\"Task: {task_details['title']}\")","breadcrumbs":"Basic Usage » Querying Tasks","id":"225","title":"Querying Tasks"},"226":{"body":"","breadcrumbs":"Basic Usage » Document Management","id":"226","title":"Document Management"},"227":{"body":"# Create a generic document\ndocument = agent.create_document({ \"type\": \"report\", \"title\": \"Q4 Sales Analysis\", \"content\": { \"summary\": \"Sales increased by 15% in Q4\", \"details\": { \"total_revenue\": 1250000, \"units_sold\": 5000, \"average_order_value\": 250 } }, \"author\": \"analytics_team\", \"created_date\": \"2024-01-15\"\n}) print(f\"Document created: {document['jacsId']}\")","breadcrumbs":"Basic Usage » Creating Documents","id":"227","title":"Creating Documents"},"228":{"body":"# Update document (creates new version)\nupdated_document = agent.update_document(document['jacsId'], { \"content\": { \"summary\": \"Sales increased by 15.3% in Q4 (revised)\", \"details\": { \"total_revenue\": 1253000, # Corrected figure \"units_sold\": 5012, \"average_order_value\": 250.1 } }, \"revision_notes\": \"Corrected revenue figures\"\n}) print(f\"Document updated to version: {updated_document['jacsVersion']}\")","breadcrumbs":"Basic Usage » Document Versioning","id":"228","title":"Document Versioning"},"229":{"body":"# Verify document signature\nis_valid = agent.verify_document(document['jacsId'])\nprint(f\"Document signature valid: {is_valid}\") # Get document history\nhistory = agent.get_document_history(document['jacsId'])\nprint(f\"Document has {len(history)} versions\")","breadcrumbs":"Basic Usage » Document Verification","id":"229","title":"Document Verification"},"23":{"body":"JACS is built specifically for AI agent communication patterns, not as a general-purpose document signing system. It understands concepts like: Agents with identities and capabilities Tasks that can be delegated and tracked Agreements between multiple parties Versioning for iterative improvements","breadcrumbs":"What is JACS? » 🎯 Agent-First Design","id":"23","title":"🎯 Agent-First Design"},"230":{"body":"","breadcrumbs":"Basic Usage » Agreement Management","id":"230","title":"Agreement Management"},"231":{"body":"# Create a multi-party agreement\nagreement = agent.create_agreement({ \"title\": \"Data Sharing Agreement\", \"description\": \"Agreement for sharing customer data between departments\", \"parties\": [\"analytics_team\", \"marketing_team\", \"legal_team\"], \"terms\": { \"data_types\": [\"customer_demographics\", \"purchase_history\"], \"usage_restrictions\": [\"no_external_sharing\", \"anonymization_required\"], \"duration\": \"12_months\" }, \"status\": \"draft\"\n}) print(f\"Agreement created: {agreement['jacsId']}\")","breadcrumbs":"Basic Usage » Creating Agreements","id":"231","title":"Creating Agreements"},"232":{"body":"# Submit agreement for approval\nsubmitted_agreement = agent.update_agreement(agreement['jacsId'], { \"status\": \"pending_approval\", \"submitted_by\": \"analytics_team\", \"submitted_date\": \"2024-01-15\"\n}) # Approve agreement (would be done by each party)\napproved_agreement = agent.approve_agreement(agreement['jacsId'], { \"approver\": \"legal_team\", \"approval_date\": \"2024-01-16\", \"notes\": \"Approved with standard terms\"\n}) # Finalize agreement\nfinal_agreement = agent.finalize_agreement(agreement['jacsId'])\nprint(f\"Agreement status: {final_agreement['status']}\")","breadcrumbs":"Basic Usage » Agreement Workflow","id":"232","title":"Agreement Workflow"},"233":{"body":"","breadcrumbs":"Basic Usage » Working with JSON Schemas","id":"233","title":"Working with JSON Schemas"},"234":{"body":"# Define a custom schema for your documents\ntask_schema = { \"type\": \"object\", \"properties\": { \"title\": {\"type\": \"string\", \"minLength\": 1}, \"description\": {\"type\": \"string\"}, \"priority\": {\"type\": \"string\", \"enum\": [\"low\", \"medium\", \"high\"]}, \"status\": {\"type\": \"string\", \"enum\": [\"pending\", \"in_progress\", \"completed\"]}, \"assignee\": {\"type\": \"string\"}, \"due_date\": {\"type\": \"string\", \"format\": \"date\"} }, \"required\": [\"title\", \"description\", \"status\"]\n} # Create task with schema validation\ntry: validated_task = agent.create_task({ \"title\": \"Validated Task\", \"description\": \"This task follows the schema\", \"priority\": \"high\", \"status\": \"pending\", \"assignee\": \"john_doe\", \"due_date\": \"2024-02-01\" }, schema=task_schema) print(\"Task created and validated successfully\")\nexcept Exception as e: print(f\"Schema validation failed: {e}\")","breadcrumbs":"Basic Usage » Schema Validation","id":"234","title":"Schema Validation"},"235":{"body":"","breadcrumbs":"Basic Usage » Error Handling","id":"235","title":"Error Handling"},"236":{"body":"import jacs try: agent = jacs.Agent(config) # Attempt to create agent agent.generate_keys() agent_doc = agent.create_agent({ \"name\": \"Test Agent\", \"description\": \"Testing error handling\" }) except jacs.ConfigurationError as e: print(f\"Configuration error: {e}\") # Handle configuration issues except jacs.CryptographicError as e: print(f\"Cryptographic error: {e}\") # Handle key generation or signing issues except jacs.ValidationError as e: print(f\"Validation error: {e}\") # Handle schema validation failures except jacs.StorageError as e: print(f\"Storage error: {e}\") # Handle file system or cloud storage issues except Exception as e: print(f\"Unexpected error: {e}\") # Handle any other errors","breadcrumbs":"Basic Usage » Common Error Patterns","id":"236","title":"Common Error Patterns"},"237":{"body":"def create_agent_safely(config): \"\"\"Create agent with comprehensive error handling\"\"\" try: agent = jacs.Agent(config) # Check if keys exist if not agent.has_keys(): print(\"Generating new keys...\") agent.generate_keys() # Check if agent document exists if not config.get(\"jacs_agent_id_and_version\"): print(\"Creating new agent...\") agent_doc = agent.create_agent({ \"name\": \"Robust Agent\", \"description\": \"Agent with error handling\" }) return agent, agent_doc else: print(\"Loading existing agent...\") return agent, None except Exception as e: print(f\"Failed to create agent: {e}\") return None, None # Usage\nagent, agent_doc = create_agent_safely(config)\nif agent: print(\"Agent ready for use\")\nelse: print(\"Failed to initialize agent\")","breadcrumbs":"Basic Usage » Robust Error Handling","id":"237","title":"Robust Error Handling"},"238":{"body":"","breadcrumbs":"Basic Usage » Configuration Management","id":"238","title":"Configuration Management"},"239":{"body":"import os\nimport json def load_config(): \"\"\"Load configuration from environment or file\"\"\" # Try environment variables first if os.getenv(\"JACS_DATA_DIRECTORY\"): return { \"jacs_data_directory\": os.getenv(\"JACS_DATA_DIRECTORY\"), \"jacs_key_directory\": os.getenv(\"JACS_KEY_DIRECTORY\"), \"jacs_default_storage\": os.getenv(\"JACS_DEFAULT_STORAGE\", \"fs\"), \"jacs_agent_key_algorithm\": os.getenv(\"JACS_AGENT_KEY_ALGORITHM\", \"Ed25519\") } # Fall back to config file try: with open(\"jacs.config.json\", \"r\") as f: return json.load(f) except FileNotFoundError: # Default configuration return { \"jacs_data_directory\": \"./jacs_data\", \"jacs_key_directory\": \"./jacs_keys\", \"jacs_default_storage\": \"fs\", \"jacs_agent_key_algorithm\": \"Ed25519\" } # Usage\nconfig = load_config()\nagent = jacs.Agent(config)","breadcrumbs":"Basic Usage » Environment-Based Configuration","id":"239","title":"Environment-Based Configuration"},"24":{"body":"Every JACS document includes: Digital signatures proving authenticity Hash verification ensuring integrity Public key cryptography for identity verification Timestamps for chronological ordering","breadcrumbs":"What is JACS? » 🔐 Trust Through Cryptography","id":"24","title":"🔐 Trust Through Cryptography"},"240":{"body":"def validate_config(config): \"\"\"Validate JACS configuration\"\"\" required_fields = [ \"jacs_data_directory\", \"jacs_key_directory\", \"jacs_default_storage\", \"jacs_agent_key_algorithm\" ] for field in required_fields: if field not in config: raise ValueError(f\"Missing required configuration field: {field}\") # Validate algorithm valid_algorithms = [\"Ed25519\", \"RSA\", \"Dilithium\"] if config[\"jacs_agent_key_algorithm\"] not in valid_algorithms: raise ValueError(f\"Invalid algorithm: {config['jacs_agent_key_algorithm']}\") # Validate storage valid_storage = [\"fs\", \"s3\", \"azure\"] if config[\"jacs_default_storage\"] not in valid_storage: raise ValueError(f\"Invalid storage backend: {config['jacs_default_storage']}\") return True # Usage\ntry: validate_config(config) agent = jacs.Agent(config)\nexcept ValueError as e: print(f\"Configuration error: {e}\")","breadcrumbs":"Basic Usage » Configuration Validation","id":"240","title":"Configuration Validation"},"241":{"body":"","breadcrumbs":"Basic Usage » Performance Tips","id":"241","title":"Performance Tips"},"242":{"body":"# Create multiple tasks efficiently\ntasks_data = [ {\"title\": f\"Task {i}\", \"description\": f\"Description {i}\", \"status\": \"pending\"} for i in range(10)\n] created_tasks = []\nfor task_data in tasks_data: task = agent.create_task(task_data) created_tasks.append(task) print(f\"Created {len(created_tasks)} tasks\")","breadcrumbs":"Basic Usage » Batch Operations","id":"242","title":"Batch Operations"},"243":{"body":"# Cache agent instance for reuse\nclass JACSManager: def __init__(self, config): self.config = config self._agent = None @property def agent(self): if self._agent is None: self._agent = jacs.Agent(self.config) return self._agent def create_task(self, task_data): return self.agent.create_task(task_data) def get_task(self, task_id): return self.agent.get_task(task_id) # Usage\nmanager = JACSManager(config)\ntask = manager.create_task({\"title\": \"Cached Task\", \"status\": \"pending\"})","breadcrumbs":"Basic Usage » Caching Agent Instance","id":"243","title":"Caching Agent Instance"},"244":{"body":"Now that you understand the basics: MCP Integration - Add Model Context Protocol support FastMCP Integration - Build advanced MCP servers API Reference - Complete API documentation Examples - More complex examples","breadcrumbs":"Basic Usage » Next Steps","id":"244","title":"Next Steps"},"245":{"body":"","breadcrumbs":"Basic Usage » Common Patterns","id":"245","title":"Common Patterns"},"246":{"body":"def process_data_pipeline(agent, data_source): \"\"\"Example data processing pipeline using JACS tasks\"\"\" # Create extraction task extract_task = agent.create_task({ \"title\": \"Extract Data\", \"description\": f\"Extract data from {data_source}\", \"status\": \"pending\", \"type\": \"extraction\" }) # Simulate extraction agent.update_task(extract_task['jacsId'], { \"status\": \"completed\", \"results\": {\"records_extracted\": 1000} }) # Create transformation task transform_task = agent.create_task({ \"title\": \"Transform Data\", \"description\": \"Clean and transform extracted data\", \"status\": \"pending\", \"type\": \"transformation\", \"depends_on\": [extract_task['jacsId']] }) # Continue pipeline... return [extract_task, transform_task] # Usage\npipeline_tasks = process_data_pipeline(agent, \"customer_database\")\nprint(f\"Created pipeline with {len(pipeline_tasks)} tasks\")","breadcrumbs":"Basic Usage » Task Pipeline","id":"246","title":"Task Pipeline"},"247":{"body":"JACS provides seamless integration with the Model Context Protocol (MCP), enabling cryptographically signed and verified communication between AI agents and MCP servers. This integration ensures that all tool calls, resource requests, and prompt interactions are authenticated and tamper-proof.","breadcrumbs":"MCP Integration » MCP Integration","id":"247","title":"MCP Integration"},"248":{"body":"JACS MCP integration provides: Cryptographic Authentication : All MCP messages are signed and verified FastMCP Support : Native integration with FastMCP servers HTTP & SSE Transports : Support for both HTTP and Server-Sent Events Transparent Security : Existing MCP code works with minimal changes","breadcrumbs":"MCP Integration » Overview","id":"248","title":"Overview"},"249":{"body":"","breadcrumbs":"MCP Integration » Quick Start","id":"249","title":"Quick Start"},"25":{"body":"JACS builds on proven standards: JSON for universal compatibility JSON Schema for structure validation RFC 3339 timestamps for consistency Standard cryptographic algorithms (RSA, Ed25519, post-quantum)","breadcrumbs":"What is JACS? » 📋 Standards-Based","id":"25","title":"📋 Standards-Based"},"250":{"body":"import jacs\nimport os\nfrom pathlib import Path\nfrom jacs.mcp import JACSMCPServer\nfrom fastmcp import FastMCP\nimport uvicorn # Setup JACS configuration\ncurrent_dir = Path(__file__).parent.absolute()\njacs_config_path = current_dir / \"jacs.config.json\" # Set password for private key\nos.environ[\"JACS_PRIVATE_KEY_PASSWORD\"] = \"your_secure_password\" # Initialize JACS\njacs.load(str(jacs_config_path)) # Create FastMCP server with JACS authentication\nmcp = JACSMCPServer(FastMCP(\"Authenticated Echo Server\")) @mcp.tool()\ndef echo_tool(text: str) -> str: \"\"\"Echo the input text with server prefix\"\"\" return f\"SERVER SAYS: {text}\" @mcp.resource(\"echo://static\")\ndef echo_resource() -> str: return \"Echo!\" @mcp.prompt(\"echo\")\ndef echo_prompt(text: str) -> str: return f\"Echo prompt: {text}\" # Get the ASGI app with JACS middleware\nsse_app_with_middleware = mcp.sse_app() if __name__ == \"__main__\": print(\"Starting JACS-enabled MCP server...\") uvicorn.run(sse_app_with_middleware, host=\"localhost\", port=8000)","breadcrumbs":"MCP Integration » Basic MCP Server with JACS","id":"250","title":"Basic MCP Server with JACS"},"251":{"body":"import asyncio\nimport os\nfrom pathlib import Path\nimport jacs\nfrom jacs.mcp import JACSMCPClient # Setup JACS configuration\ncurrent_dir = Path(__file__).parent.absolute()\njacs_config_path = current_dir / \"jacs.client.config.json\" # Set password for private key\nos.environ[\"JACS_PRIVATE_KEY_PASSWORD\"] = \"your_secure_password\" # Initialize JACS\njacs.load(str(jacs_config_path)) async def main(): server_url = \"http://localhost:8000/sse\" try: client = JACSMCPClient(server_url) async with client: # Call authenticated tool result = await client.call_tool(\"echo_tool\", { \"text\": \"Hello from authenticated client!\" }) print(f\"Tool result: {result}\") # Read authenticated resource resource = await client.read_resource(\"echo://static\") print(f\"Resource: {resource}\") except Exception as e: print(f\"Error: {e}\") if __name__ == \"__main__\": asyncio.run(main())","breadcrumbs":"MCP Integration » Basic MCP Client with JACS","id":"251","title":"Basic MCP Client with JACS"},"252":{"body":"","breadcrumbs":"MCP Integration » Configuration","id":"252","title":"Configuration"},"253":{"body":"Create a jacs.config.json file for your server and client: { \"$schema\": \"https://hai.ai/schemas/jacs.config.schema.json\", \"jacs_agent_id_and_version\": \"your-agent-id:version\", \"jacs_agent_key_algorithm\": \"RSA-PSS\", \"jacs_agent_private_key_filename\": \"private.pem.enc\", \"jacs_agent_public_key_filename\": \"public.pem\", \"jacs_data_directory\": \"./jacs\", \"jacs_default_storage\": \"fs\", \"jacs_key_directory\": \"./jacs_keys\", \"jacs_private_key_password\": \"your_password\", \"jacs_use_security\": \"true\"\n}","breadcrumbs":"MCP Integration » JACS Configuration File","id":"253","title":"JACS Configuration File"},"254":{"body":"Generate cryptographic keys for your agents: import jacs # Load configuration\njacs.load(\"jacs.config.json\") # Generate keys (only needed once per agent)\nagent = jacs.Agent()\nagent.generate_keys() # Create agent document\nagent_doc = agent.create_agent({ \"name\": \"MCP Server Agent\", \"description\": \"Agent for MCP server authentication\", \"type\": \"mcp_server\"\n}) print(f\"Agent ID: {agent_doc['jacsId']}\")","breadcrumbs":"MCP Integration » Key Generation","id":"254","title":"Key Generation"},"255":{"body":"","breadcrumbs":"MCP Integration » Integration Patterns","id":"255","title":"Integration Patterns"},"256":{"body":"The JACSMCPServer wrapper automatically adds cryptographic middleware: from jacs.mcp import JACSMCPServer\nfrom fastmcp import FastMCP # Create FastMCP server\nbase_server = FastMCP(\"My Server\") # Wrap with JACS authentication\nauthenticated_server = JACSMCPServer(base_server) # All decorators work normally\n@authenticated_server.tool()\ndef my_tool(data: str) -> str: return f\"Processed: {data}\"","breadcrumbs":"MCP Integration » 1. FastMCP with JACS Middleware","id":"256","title":"1. FastMCP with JACS Middleware"},"257":{"body":"For HTTP-based MCP servers, you can manually sign responses: from fastapi import FastAPI, Request\nfrom fastapi.responses import JSONResponse\nimport jacs app = FastAPI() @app.post(\"/api/tool\")\nasync def call_tool(request: Request): # Verify incoming request body = await request.body() verified_data = jacs.verify_request(body.decode()) # Process the tool call result = {\"message\": \"Tool executed\", \"data\": verified_data} # Sign and return response signed_response = jacs.sign_response(result) return JSONResponse(content=signed_response)","breadcrumbs":"MCP Integration » 2. HTTP MCP with Manual Signing","id":"257","title":"2. HTTP MCP with Manual Signing"},"258":{"body":"For stdio-based MCP servers: from mcp.server.fastmcp import FastMCP\nimport jacs # Initialize JACS\njacs.load(\"jacs.config.json\") mcp = FastMCP(\"Stdio Server\") @mcp.tool()\ndef secure_tool(input_data: str) -> str: \"\"\"A tool that processes signed input\"\"\" # Input is automatically verified by JACS middleware return f\"Securely processed: {input_data}\" if __name__ == \"__main__\": # Run with stdio transport mcp.run()","breadcrumbs":"MCP Integration » 3. Standard MCP with Stdio","id":"258","title":"3. Standard MCP with Stdio"},"259":{"body":"","breadcrumbs":"MCP Integration » Advanced Usage","id":"259","title":"Advanced Usage"},"26":{"body":"","breadcrumbs":"What is JACS? » Key Concepts","id":"26","title":"Key Concepts"},"260":{"body":"from jacs.mcp import JACSMCPServer\nfrom fastmcp import FastMCP\nimport jacs class CustomJACSServer: def __init__(self, base_server: FastMCP): self.base_server = base_server self.setup_middleware() def setup_middleware(self): # Custom verification logic @self.base_server.middleware(\"http\") async def custom_auth(request, call_next): # Custom JACS verification if self.should_verify(request): body = await request.body() verified = jacs.verify_request(body.decode()) # Update request with verified data response = await call_next(request) # Custom signing logic if self.should_sign(response): # Sign response pass return response def should_verify(self, request) -> bool: # Custom logic for when to verify return True def should_sign(self, response) -> bool: # Custom logic for when to sign return True","breadcrumbs":"MCP Integration » Custom Authentication Logic","id":"260","title":"Custom Authentication Logic"},"261":{"body":"import jacs\nfrom jacs.mcp import JACSMCPServer, JACSMCPClient # Server side - configure for multiple agents\nserver_config = { \"trusted_agents\": [\"agent1-id\", \"agent2-id\"], \"require_signatures\": True\n} mcp_server = JACSMCPServer(FastMCP(\"Multi-Agent Server\")) @mcp_server.tool()\ndef multi_agent_tool(data: str, agent_context: dict) -> str: \"\"\"Tool that can be called by multiple authenticated agents\"\"\" agent_id = agent_context.get(\"agent_id\") return f\"Agent {agent_id} processed: {data}\" # Client side - each agent uses its own keys\nclient1 = JACSMCPClient(\"http://server:8000/sse\")\nclient2 = JACSMCPClient(\"http://server:8000/sse\")","breadcrumbs":"MCP Integration » Multi-Agent Authentication","id":"261","title":"Multi-Agent Authentication"},"262":{"body":"","breadcrumbs":"MCP Integration » Error Handling","id":"262","title":"Error Handling"},"263":{"body":"import jacs\nfrom jacs.mcp import JACSMCPClient async def robust_mcp_client(): try: client = JACSMCPClient(\"http://localhost:8000/sse\") async with client: result = await client.call_tool(\"my_tool\", {\"data\": \"test\"}) return result except jacs.CryptographicError as e: print(f\"Signature verification failed: {e}\") # Handle invalid signatures except jacs.ConfigurationError as e: print(f\"JACS configuration error: {e}\") # Handle missing keys or config except ConnectionError as e: print(f\"MCP connection failed: {e}\") # Handle network issues except Exception as e: print(f\"Unexpected error: {e}\")","breadcrumbs":"MCP Integration » Common JACS MCP Errors","id":"263","title":"Common JACS MCP Errors"},"264":{"body":"import logging\nimport jacs # Enable detailed JACS logging\nlogging.basicConfig(level=logging.DEBUG)\njacs_logger = logging.getLogger(\"jacs\")\njacs_logger.setLevel(logging.DEBUG) # Enable MCP debugging\nmcp_logger = logging.getLogger(\"mcp\")\nmcp_logger.setLevel(logging.DEBUG) # Your MCP code here...","breadcrumbs":"MCP Integration » Debugging Authentication Issues","id":"264","title":"Debugging Authentication Issues"},"265":{"body":"","breadcrumbs":"MCP Integration » Production Deployment","id":"265","title":"Production Deployment"},"266":{"body":"Key Management : Store private keys securely Environment Variables : Use environment variables for passwords Network Security : Use TLS for network transport Key Rotation : Implement key rotation policies import os\nimport jacs # Production configuration\nconfig = { \"jacs_key_directory\": os.getenv(\"JACS_KEY_DIR\", \"/secure/keys\"), \"jacs_private_key_password\": os.getenv(\"JACS_KEY_PASSWORD\"), \"jacs_use_security\": \"true\", \"jacs_agent_key_algorithm\": \"RSA-PSS\"\n} # Load with production settings\njacs.load_config(config)","breadcrumbs":"MCP Integration » Security Best Practices","id":"266","title":"Security Best Practices"},"267":{"body":"FROM python:3.11-slim WORKDIR /app # Install dependencies\nCOPY requirements.txt .\nRUN pip install -r requirements.txt # Copy application\nCOPY . . # Create secure key directory\nRUN mkdir -p /secure/keys && chmod 700 /secure/keys # Set environment variables\nENV JACS_KEY_DIR=/secure/keys\nENV JACS_USE_SECURITY=true # Run MCP server\nCMD [\"python\", \"mcp_server.py\"]","breadcrumbs":"MCP Integration » Docker Deployment","id":"267","title":"Docker Deployment"},"268":{"body":"","breadcrumbs":"MCP Integration » Testing","id":"268","title":"Testing"},"269":{"body":"import pytest\nimport jacs\nfrom jacs.mcp import JACSMCPServer\nfrom fastmcp import FastMCP\nfrom fastmcp.client import Client\nfrom fastmcp.client.transports import FastMCPTransport @pytest.fixture\ndef jacs_mcp_server(): # Setup test configuration jacs.load(\"test.config.json\") server = FastMCP(\"Test Server\") return JACSMCPServer(server) @pytest.fixture\ndef test_client(jacs_mcp_server): transport = FastMCPTransport(jacs_mcp_server) return Client(transport) async def test_authenticated_tool(test_client): async with test_client: result = await test_client.call_tool(\"echo_tool\", {\"text\": \"test\"}) assert \"test\" in str(result)","breadcrumbs":"MCP Integration » Unit Testing MCP Tools","id":"269","title":"Unit Testing MCP Tools"},"27":{"body":"An Agent is an autonomous entity with: A unique identity (UUID) Cryptographic keys for signing Capabilities defined in services The ability to create and verify documents","breadcrumbs":"What is JACS? » Agents","id":"27","title":"Agents"},"270":{"body":"","breadcrumbs":"MCP Integration » Performance Considerations","id":"270","title":"Performance Considerations"},"271":{"body":"Key Caching : JACS automatically caches keys Batch Operations : Group multiple tool calls when possible Connection Pooling : Reuse client connections Async Operations : Use async/await properly # Efficient client usage\nasync def efficient_mcp_usage(): client = JACSMCPClient(\"http://server:8000/sse\") # Single connection for multiple operations async with client: # Batch multiple tool calls tasks = [ client.call_tool(\"tool1\", {\"data\": f\"item{i}\"}) for i in range(10) ] results = await asyncio.gather(*tasks) return results","breadcrumbs":"MCP Integration » Optimization Tips","id":"271","title":"Optimization Tips"},"272":{"body":"FastMCP Integration - Advanced FastMCP patterns API Reference - Complete API documentation Examples - More complex examples Security Guide - Security best practices","breadcrumbs":"MCP Integration » Next Steps","id":"272","title":"Next Steps"},"273":{"body":"","breadcrumbs":"API Reference » API Reference","id":"273","title":"API Reference"},"274":{"body":"","breadcrumbs":"JSON Schemas » JSON Schemas","id":"274","title":"JSON Schemas"},"275":{"body":"","breadcrumbs":"Agent Schema » Agent Schema","id":"275","title":"Agent Schema"},"276":{"body":"","breadcrumbs":"Document Schema » Document Schema","id":"276","title":"Document Schema"},"277":{"body":"","breadcrumbs":"Task Schema » Task Schema","id":"277","title":"Task Schema"},"278":{"body":"","breadcrumbs":"Configuration » Configuration","id":"278","title":"Configuration"},"279":{"body":"","breadcrumbs":"Security Model » Security Model","id":"279","title":"Security Model"},"28":{"body":"A Document is any JSON object that includes: JACS header fields (ID, version, creator, etc.) A cryptographic signature A hash for integrity verification Business logic specific to the document type","breadcrumbs":"What is JACS? » Documents","id":"28","title":"Documents"},"280":{"body":"","breadcrumbs":"Cryptographic Algorithms » Cryptographic Algorithms","id":"280","title":"Cryptographic Algorithms"},"281":{"body":"","breadcrumbs":"Storage Backends » Storage Backends","id":"281","title":"Storage Backends"},"282":{"body":"","breadcrumbs":"Custom Schemas » Custom Schemas","id":"282","title":"Custom Schemas"},"283":{"body":"","breadcrumbs":"Testing » Testing","id":"283","title":"Testing"},"284":{"body":"","breadcrumbs":"Model Context Protocol (MCP) » Model Context Protocol (MCP)","id":"284","title":"Model Context Protocol (MCP)"},"285":{"body":"","breadcrumbs":"Web Servers » Web Servers","id":"285","title":"Web Servers"},"286":{"body":"","breadcrumbs":"Databases » Databases","id":"286","title":"Databases"},"287":{"body":"","breadcrumbs":"CLI Examples » CLI Examples","id":"287","title":"CLI Examples"},"288":{"body":"","breadcrumbs":"Node.js Examples » Node.js Examples","id":"288","title":"Node.js Examples"},"289":{"body":"","breadcrumbs":"Python Examples » Python Examples","id":"289","title":"Python Examples"},"29":{"body":"A Task is a special document type representing: Work to be performed Success/failure criteria Input/output specifications Delegation and completion tracking","breadcrumbs":"What is JACS? » Tasks","id":"29","title":"Tasks"},"290":{"body":"","breadcrumbs":"Integration Examples » Integration Examples","id":"290","title":"Integration Examples"},"291":{"body":"This page provides a comprehensive reference for all JACS command-line interface commands.","breadcrumbs":"CLI Command Reference » CLI Command Reference","id":"291","title":"CLI Command Reference"},"292":{"body":"","breadcrumbs":"CLI Command Reference » Global Commands","id":"292","title":"Global Commands"},"293":{"body":"Prints version and build information for the JACS installation. jacs version","breadcrumbs":"CLI Command Reference » jacs version","id":"293","title":"jacs version"},"294":{"body":"Initialize JACS by creating both configuration and agent (with cryptographic keys). This is typically the first command run when setting up JACS. jacs init","breadcrumbs":"CLI Command Reference » jacs init","id":"294","title":"jacs init"},"295":{"body":"Print help information for JACS commands. jacs help [COMMAND]","breadcrumbs":"CLI Command Reference » jacs help","id":"295","title":"jacs help"},"296":{"body":"","breadcrumbs":"CLI Command Reference » Configuration Commands","id":"296","title":"Configuration Commands"},"297":{"body":"Work with JACS configuration settings. jacs config [SUBCOMMAND] Note: Specific subcommands for config are not detailed in the current help output.","breadcrumbs":"CLI Command Reference » jacs config","id":"297","title":"jacs config"},"298":{"body":"","breadcrumbs":"CLI Command Reference » Agent Commands","id":"298","title":"Agent Commands"},"299":{"body":"Work with JACS agents - the cryptographic identities that sign and verify documents. jacs agent [SUBCOMMAND] Note: Specific subcommands for agent management are not detailed in the current help output.","breadcrumbs":"CLI Command Reference » jacs agent","id":"299","title":"jacs agent"},"3":{"body":"JACS is available in three languages, each with its own strengths:","breadcrumbs":"Introduction » Available Implementations","id":"3","title":"Available Implementations"},"30":{"body":"An Agreement is a mechanism for: Multiple agents to consent to terms Tracking signatures from all required parties Ensuring all participants have signed before proceeding Creating binding commitments between agents","breadcrumbs":"What is JACS? » Agreements","id":"30","title":"Agreements"},"300":{"body":"","breadcrumbs":"CLI Command Reference » Task Commands","id":"300","title":"Task Commands"},"301":{"body":"Work with JACS agent tasks - structured workflows between agents. jacs task [SUBCOMMAND] Note: Specific subcommands for task management are not detailed in the current help output.","breadcrumbs":"CLI Command Reference » jacs task","id":"301","title":"jacs task"},"302":{"body":"The jacs document command provides comprehensive document management capabilities.","breadcrumbs":"CLI Command Reference » Document Commands","id":"302","title":"Document Commands"},"303":{"body":"Create a new JACS document, either by embedding or parsing a document with optional file attachments. Usage: jacs document create [OPTIONS] Options: -a
- Path to the agent file. If not specified, uses config jacs_agent_id_and_version -f - Path to input file. Must be JSON format -o