jep-agent-sdk 1.0.1__tar.gz

jep_agent_sdk-1.0.1/.github/workflows/ci.yml

@@ -0,0 +1,42 @@
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install pytest pytest-cov pytest-asyncio ruff black
+        pip install -e ".[langchain,openai]"
+
+    - name: Lint
+      run: |
+        ruff check jep/ tests/
+        black --check jep/ tests/
+
+    - name: Test
+      run: python -m pytest tests/ -v --cov=jep --cov-report=xml
+
+    - name: Upload coverage
+      uses: codecov/codecov-action@v4
+      with:
+        files: ./coverage.xml
+        fail_ci_if_error: false

jep_agent_sdk-1.0.1/.github/workflows/release.yml

@@ -0,0 +1,55 @@
+name: Publish versioned release
+on:
+  push:
+    branches: [main]
+    paths: [VERSION, '.github/workflows/release.yml']
+  workflow_dispatch:
+permissions:
+  contents: read
+concurrency:
+  group: release-${{ github.repository }}
+  cancel-in-progress: false
+jobs:
+  release:
+    if: github.ref == 'refs/heads/main'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - run: pip install build twine pytest pytest-asyncio httpx -e .
+      - run: python -m pytest tests -q
+      - run: python -m build && twine check dist/*
+      - name: Validate release version
+        run: |
+          python -c "import pathlib,re; v=pathlib.Path('VERSION').read_text().strip(); assert re.fullmatch(r'[0-9]+\.[0-9]+\.[0-9]+(?:a[0-9]+)?',v)"
+      - uses: actions/upload-artifact@v4
+        with:
+          name: distributions
+          path: dist/
+      - name: Publish versioned GitHub release
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          version=$(cat VERSION)
+          if gh release view "v$version" >/dev/null 2>&1; then
+            echo 'This version already has a release; refusing to overwrite it.'
+            exit 1
+          fi
+          gh release create "v$version" --target "$GITHUB_SHA" --title "v$version" --notes-file RELEASE-NOTES.md dist/*
+  pypi:
+    needs: release
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: distributions
+          path: downloaded/
+      - run: mkdir dist && cp downloaded/*.whl downloaded/*.tar.gz dist/
+      - name: Publish to PyPI using the configured trusted publisher
+        uses: pypa/gh-action-pypi-publish@release/v1

jep_agent_sdk-1.0.1/.gitignore

@@ -0,0 +1,37 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+.env
+.venv
+env/
+venv/
+.idea/
+.vscode/
+*.pem
+*.key
+*.jsonl
+*.db
+jep_chain_local.jsonl
+mcp_jep_chain.jsonl
+.pytest_cache/
+.coverage
+htmlcov/
+poetry.lock
+coverage.xml

jep_agent_sdk-1.0.1/CHANGELOG.md

@@ -0,0 +1,13 @@
+# Changelog
+
+## 1.0.0 (2026-04-26)
+
+- Initial release
+- Full JEP-04 compliance (RFC 8785 JCS, JWS EdDSA, anti-replay)
+- JAC-01 extension support (`task_based_on`, fault recording)
+- TRUE zero-code adapters: LangChain (`import .auto`), OpenAI (`import .auto`), MCP
+- DeterminabilityGuard runtime gate for causal sufficiency checks
+- Causal topology web viewer (SVG force-directed graph)
+- Compliance export (`jep export`) with embedded causal graph
+- CLI tools: `jep web`, `jep verify`, `jep export`
+- Docker & docker-compose support

jep_agent_sdk-1.0.1/CONTRIBUTING.md

@@ -0,0 +1,29 @@
+# Contributing to JEP-Agent SDK
+
+## Setup
+
+```bash
+git clone https://github.com/hjs-spec/jep-agent-sdk.git
+cd jep-agent-sdk
+make install
+```
+
+## Testing
+
+```bash
+make test
+```
+
+## Code Style
+
+```bash
+make format
+make lint
+```
+
+## Pull Request Process
+
+1. Ensure tests pass (`make test`)
+2. Update examples if API changes
+3. Update `CHANGELOG.md`
+```

jep_agent_sdk-1.0.1/HARDENING.md

@@ -0,0 +1,24 @@
+# Implementation hardening — September 2026
+
+Do not report unverified or unfinished agent executions as valid.
+
+## Changes
+
+Signature verification binds the embedded signed payload to the current event. Chains verify every event, including the first, with a trusted public key. Exported events are copied. Missing keys return UNVERIFIED and unsigned chains do not pass integrity verification. Nonces are consumed after signature and policy checks. Async wrappers await completion and record errors/cancellation as termination. LangChain callback IDs no longer refer to a nonexistent field. The UI renders event fields as text. validate.py now exercises the actual signed API.
+
+## Validation
+
+```sh
+python -m pytest -q
+python validate.py
+ruff check jep/ tests/
+black --check jep/ tests/
+```
+
+## Compatibility and remaining limits
+
+Legacy-04 embedded EdDSA signatures and legacy unsigned-event link hashes remain unchanged. This SDK is not the v0.6 wire SDK. verify_chain(public_key=...) is required for imported signed archives; unsigned traces remain available for recording. The jep import/console namespace still overlaps other packages; install in a separate environment. OpenAI monkey patching remains a legacy Completions integration; use the dedicated middleware for current Agents SDK integration.
+
+## Follow-up hardening
+
+The legacy synchronous Chat Completions patch is idempotent and retains events in the public trace manager instead of discarding each call chain. Quickstart now uses explicit @record instrumentation and a signing key. Documentation distinguishes this historical adapter from the current Agents SDK middleware and removes unsupported production/standardization claims.

jep_agent_sdk-1.0.1/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, Yuqiang Wang (HJS Foundation Ltd.)
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

jep_agent_sdk-1.0.1/Makefile

@@ -0,0 +1,34 @@
+.PHONY: install test lint format clean build publish web docker compose
+
+install:
+	pip install -e ".[dev,langchain,openai]"
+
+test:
+	pytest tests/ -v --tb=short
+
+lint:
+	ruff check jep/ tests/
+	black --check jep/ tests/
+
+format:
+	black jep/ tests/
+	ruff check --fix jep/ tests/
+
+clean:
+	rm -rf build/ dist/ *.egg-info .pytest_cache htmlcov/
+	find . -type d -name __pycache__ -exec rm -rf {} + 2>/dev/null || true
+
+build:
+	python -m build
+
+publish:
+	python -m twine upload dist/*
+
+web:
+	jep web --port 8080 --reload
+
+docker:
+	docker build -t jep-agent-sdk:latest -f docker/Dockerfile .
+
+compose:
+	docker-compose up --build

jep_agent_sdk-1.0.1/PKG-INFO

@@ -0,0 +1,226 @@
+Metadata-Version: 2.5
+Name: jep-agent-sdk
+Version: 1.0.1
+Summary: JEP-Agent SDK 1.0 — Legacy reference implementation of JEP-04 and JAC-01
+Project-URL: Homepage, https://github.com/hjs-spec/jep-agent-sdk
+Project-URL: Documentation, https://datatracker.ietf.org/doc/draft-wang-jep-judgment-event-protocol-04/
+Project-URL: Repository, https://github.com/hjs-spec/jep-agent-sdk
+Project-URL: Issues, https://github.com/hjs-spec/jep-agent-sdk/issues
+Author-email: Yuqiang Wang <signal@humanjudgment.org>
+License-Expression: BSD-3-Clause
+License-File: LICENSE
+Keywords: accountability,agent,ai-governance,audit,jac,jep,langchain
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Security :: Cryptography
+Requires-Python: >=3.10
+Requires-Dist: click>=8.0.0
+Requires-Dist: cryptography>=41.0.0
+Requires-Dist: fastapi>=0.100.0
+Requires-Dist: jcs>=0.2.0
+Requires-Dist: python-multipart>=0.0.18
+Requires-Dist: rich>=13.0.0
+Requires-Dist: uvicorn>=0.23.0
+Provides-Extra: dev
+Requires-Dist: black>=24.0.0; extra == 'dev'
+Requires-Dist: httpx>=0.24.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
+Requires-Dist: pytest-cov>=6.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.3.0; extra == 'dev'
+Provides-Extra: langchain
+Requires-Dist: langchain-core>=0.3.0; extra == 'langchain'
+Requires-Dist: langchain>=0.3.0; extra == 'langchain'
+Provides-Extra: openai
+Requires-Dist: openai>=1.0.0; extra == 'openai'
+Description-Content-Type: text/markdown
+
+> Historical repository.
+>
+> This repository reflects an earlier design line and is no longer the current implementation track.
+>
+> Current versions:
+>
+> - JEP v0.6: https://github.com/hjs-spec/jep-v06
+> - JEP API v0.6: https://github.com/hjs-spec/jep-api
+> - HJS v0.5: https://github.com/hjs-spec/hjs-05
+> - JAC v0.5: https://github.com/hjs-spec/jac-agent-02
+
+# JEP-Agent SDK 1.0
+
+[![IETF Draft](https://img.shields.io/badge/IETF-JEP--04-blue)](https://datatracker.ietf.org/doc/draft-wang-jep-judgment-event-protocol-04/)
+[![IETF Draft](https://img.shields.io/badge/IETF-JAC--01-purple)](https://datatracker.ietf.org/doc/draft-wang-jac-01/)
+[![PyPI](https://img.shields.io/badge/pip-jep--agent--sdk-blue)](https://pypi.org/project/jep-agent-sdk/)
+[![License](https://img.shields.io/badge/license-BSD--3--Clause-green.svg)](LICENSE)
+[![Python](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/)
+
+**Historical tracing SDK with explicit instrumentation and local verification.**
+
+JEP-Agent SDK is an experimental implementation of the [Judgment Event Protocol (JEP-04)](https://datatracker.ietf.org/doc/draft-wang-jep-judgment-event-protocol-04/) and [JAC-01](https://datatracker.ietf.org/doc/draft-wang-jac-01/). It records instrumented calls using the historical event format. A configured signing key and independently trusted verification key are required for signature assurance.
+
+---
+
+## Install
+
+```bash
+pip install jep-agent-sdk
+```
+
+With framework adapters:
+```bash
+pip install jep-agent-sdk[langchain,openai]
+```
+
+> For current MCP and OpenAI Agents integrations, use `jep-mcp-wrapper` and `jep-openai-agents-middleware`. This repository retains legacy adapters.
+
+---
+
+## 30-Second Quickstart
+
+```python
+from jep import trace
+from jep.recorder import record
+from cryptography.hazmat.primitives.asymmetric.ed25519 import Ed25519PrivateKey
+
+trace.enable(issuer="did:example:agent-001", private_key=Ed25519PrivateKey.generate())
+
+@record(issuer="did:example:agent-001", chain=trace.chain)
+def my_agent(query: str) -> str:
+    return f"Result for {query}"
+
+my_agent("hello")
+trace.view()   # See the J/D/T/V event chain in your terminal
+```
+
+---
+
+## Legacy framework adapters
+
+| Framework | Integration | Your Code Changes |
+|-----------|-------------|-------------------|
+| **LangChain** | `import jep.adapters.langchain.auto` | Experimental patch |
+| **OpenAI Chat Completions (legacy)** | `import jep.adapters.openai_agents.auto` | Experimental patch |
+| **MCP** | `from jep.adapters.mcp import JEPMCPServer` | **One line** |
+
+---
+
+## Causal Web Viewer
+
+```bash
+jep web --port 8080
+```
+
+Drag-and-drop your `events.jsonl`. Get an interactive force-directed causal graph. Click any node to inspect the full JEP event. Pan, zoom, export.
+
+---
+
+## Determinability Guard — Stop Agents from Guessing
+
+```python
+from jep.determinability import DeterminabilityGuard
+
+guard = DeterminabilityGuard(
+    evidence_fn=lambda ctx: len(ctx.get("tools_used", [])),
+    target_fn=lambda ctx: ctx.get("outcome"),
+    knowledge_base=[{"tools_used": ["search", "calc"], "outcome": 1},
+                    {"tools_used": ["search"], "outcome": 0}],
+    on_insufficient="raise",
+)
+
+@guard.require_determinable
+def my_agent(query: str, tools_used: list) -> str:
+    ...
+```
+
+**What it does:** If your agent hasn't gathered enough evidence to make a deterministic decision, the guard blocks execution and tells you exactly what's missing. This is an application-defined gate; it does not guarantee factual accuracy.
+
+---
+
+## CLI Tools
+
+```bash
+# Verify signatures, chains, and anti-replay
+jep verify events.jsonl --public-key key.pem
+
+# Export a full compliance report (HTML with embedded causal graph)
+jep export events.jsonl --output report.html
+```
+
+---
+
+## What is JEP?
+
+JEP (Judgment Event Protocol) is a minimal log format proposed in an individual IETF Internet-Draft for AI agent decisions. It defines four immutable verbs:
+
+| Verb | Meaning | RFC 2119 |
+|------|---------|----------|
+| **J** | Judge — Initiate a decision | MUST |
+| **D** | Delegate — Transfer authority | MUST |
+| **T** | Terminate — Close lifecycle | MUST |
+| **V** | Verify — Validate an event | MUST |
+
+Signing is optional at recording time. Unsigned events are unverified. This historical format uses its own embedded JWS payload and hash links; use `jep-v06` for the current detached JWS/JCS conformance baseline.
+
+---
+
+## Project Structure
+
+```
+jep/
+├── core/           # JEP-04 protocol engine (event, crypto, verifier, chain)
+├── primitives.py   # J/D/T/V convenience wrappers
+├── recorder.py     # @record decorator + global trace manager
+├── determinability.py  # Causal sufficiency gate (DeterminabilityGuard)
+├── extensions/
+│   └── jac.py      # JAC-01 cross-agent accountability
+├── adapters/
+│   ├── langchain.py      # TRUE zero-code auto-patch
+│   ├── openai_agents.py  # TRUE zero-code auto-patch
+│   └── mcp.py            # MCP server wrapper
+├── cli/
+│   └── main.py     # jep web | jep verify | jep export
+└── web/
+    └── static/
+        └── index.html   # Drag-and-drop causal topology viewer
+```
+
+---
+
+## Documentation
+
+- [Architecture & Design Principles](docs/ARCHITECTURE.md)
+- [API Reference](docs/API.md)
+- [JEP-04 Internet-Draft](https://datatracker.ietf.org/doc/draft-wang-jep-judgment-event-protocol-04/)
+- [JAC-01 Internet-Draft](https://datatracker.ietf.org/doc/draft-wang-jac-01/)
+
+---
+
+## Contributing
+
+```bash
+git clone https://github.com/hjs-spec/jep-agent-sdk.git
+cd jep-agent-sdk
+make install
+make test
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md).
+
+---
+
+## Author
+
+**Yuqiang Wang**  
+HJS Foundation Ltd.  
+Email: signal@humanjudgment.org  
+GitHub: [@hjs-spec](https://github.com/hjs-spec)
+
+---
+
+*JEP-Agent SDK is released under BSD-3-Clause. The protocol draft is an individual IETF Internet-Draft and does not represent IETF endorsement.*

jep_agent_sdk-1.0.1/README.md

@@ -0,0 +1,183 @@
+> Historical repository.
+>
+> This repository reflects an earlier design line and is no longer the current implementation track.
+>
+> Current versions:
+>
+> - JEP v0.6: https://github.com/hjs-spec/jep-v06
+> - JEP API v0.6: https://github.com/hjs-spec/jep-api
+> - HJS v0.5: https://github.com/hjs-spec/hjs-05
+> - JAC v0.5: https://github.com/hjs-spec/jac-agent-02
+
+# JEP-Agent SDK 1.0
+
+[![IETF Draft](https://img.shields.io/badge/IETF-JEP--04-blue)](https://datatracker.ietf.org/doc/draft-wang-jep-judgment-event-protocol-04/)
+[![IETF Draft](https://img.shields.io/badge/IETF-JAC--01-purple)](https://datatracker.ietf.org/doc/draft-wang-jac-01/)
+[![PyPI](https://img.shields.io/badge/pip-jep--agent--sdk-blue)](https://pypi.org/project/jep-agent-sdk/)
+[![License](https://img.shields.io/badge/license-BSD--3--Clause-green.svg)](LICENSE)
+[![Python](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/)
+
+**Historical tracing SDK with explicit instrumentation and local verification.**
+
+JEP-Agent SDK is an experimental implementation of the [Judgment Event Protocol (JEP-04)](https://datatracker.ietf.org/doc/draft-wang-jep-judgment-event-protocol-04/) and [JAC-01](https://datatracker.ietf.org/doc/draft-wang-jac-01/). It records instrumented calls using the historical event format. A configured signing key and independently trusted verification key are required for signature assurance.
+
+---
+
+## Install
+
+```bash
+pip install jep-agent-sdk
+```
+
+With framework adapters:
+```bash
+pip install jep-agent-sdk[langchain,openai]
+```
+
+> For current MCP and OpenAI Agents integrations, use `jep-mcp-wrapper` and `jep-openai-agents-middleware`. This repository retains legacy adapters.
+
+---
+
+## 30-Second Quickstart
+
+```python
+from jep import trace
+from jep.recorder import record
+from cryptography.hazmat.primitives.asymmetric.ed25519 import Ed25519PrivateKey
+
+trace.enable(issuer="did:example:agent-001", private_key=Ed25519PrivateKey.generate())
+
+@record(issuer="did:example:agent-001", chain=trace.chain)
+def my_agent(query: str) -> str:
+    return f"Result for {query}"
+
+my_agent("hello")
+trace.view()   # See the J/D/T/V event chain in your terminal
+```
+
+---
+
+## Legacy framework adapters
+
+| Framework | Integration | Your Code Changes |
+|-----------|-------------|-------------------|
+| **LangChain** | `import jep.adapters.langchain.auto` | Experimental patch |
+| **OpenAI Chat Completions (legacy)** | `import jep.adapters.openai_agents.auto` | Experimental patch |
+| **MCP** | `from jep.adapters.mcp import JEPMCPServer` | **One line** |
+
+---
+
+## Causal Web Viewer
+
+```bash
+jep web --port 8080
+```
+
+Drag-and-drop your `events.jsonl`. Get an interactive force-directed causal graph. Click any node to inspect the full JEP event. Pan, zoom, export.
+
+---
+
+## Determinability Guard — Stop Agents from Guessing
+
+```python
+from jep.determinability import DeterminabilityGuard
+
+guard = DeterminabilityGuard(
+    evidence_fn=lambda ctx: len(ctx.get("tools_used", [])),
+    target_fn=lambda ctx: ctx.get("outcome"),
+    knowledge_base=[{"tools_used": ["search", "calc"], "outcome": 1},
+                    {"tools_used": ["search"], "outcome": 0}],
+    on_insufficient="raise",
+)
+
+@guard.require_determinable
+def my_agent(query: str, tools_used: list) -> str:
+    ...
+```
+
+**What it does:** If your agent hasn't gathered enough evidence to make a deterministic decision, the guard blocks execution and tells you exactly what's missing. This is an application-defined gate; it does not guarantee factual accuracy.
+
+---
+
+## CLI Tools
+
+```bash
+# Verify signatures, chains, and anti-replay
+jep verify events.jsonl --public-key key.pem
+
+# Export a full compliance report (HTML with embedded causal graph)
+jep export events.jsonl --output report.html
+```
+
+---
+
+## What is JEP?
+
+JEP (Judgment Event Protocol) is a minimal log format proposed in an individual IETF Internet-Draft for AI agent decisions. It defines four immutable verbs:
+
+| Verb | Meaning | RFC 2119 |
+|------|---------|----------|
+| **J** | Judge — Initiate a decision | MUST |
+| **D** | Delegate — Transfer authority | MUST |
+| **T** | Terminate — Close lifecycle | MUST |
+| **V** | Verify — Validate an event | MUST |
+
+Signing is optional at recording time. Unsigned events are unverified. This historical format uses its own embedded JWS payload and hash links; use `jep-v06` for the current detached JWS/JCS conformance baseline.
+
+---
+
+## Project Structure
+
+```
+jep/
+├── core/           # JEP-04 protocol engine (event, crypto, verifier, chain)
+├── primitives.py   # J/D/T/V convenience wrappers
+├── recorder.py     # @record decorator + global trace manager
+├── determinability.py  # Causal sufficiency gate (DeterminabilityGuard)
+├── extensions/
+│   └── jac.py      # JAC-01 cross-agent accountability
+├── adapters/
+│   ├── langchain.py      # TRUE zero-code auto-patch
+│   ├── openai_agents.py  # TRUE zero-code auto-patch
+│   └── mcp.py            # MCP server wrapper
+├── cli/
+│   └── main.py     # jep web | jep verify | jep export
+└── web/
+    └── static/
+        └── index.html   # Drag-and-drop causal topology viewer
+```
+
+---
+
+## Documentation
+
+- [Architecture & Design Principles](docs/ARCHITECTURE.md)
+- [API Reference](docs/API.md)
+- [JEP-04 Internet-Draft](https://datatracker.ietf.org/doc/draft-wang-jep-judgment-event-protocol-04/)
+- [JAC-01 Internet-Draft](https://datatracker.ietf.org/doc/draft-wang-jac-01/)
+
+---
+
+## Contributing
+
+```bash
+git clone https://github.com/hjs-spec/jep-agent-sdk.git
+cd jep-agent-sdk
+make install
+make test
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md).
+
+---
+
+## Author
+
+**Yuqiang Wang**  
+HJS Foundation Ltd.  
+Email: signal@humanjudgment.org  
+GitHub: [@hjs-spec](https://github.com/hjs-spec)
+
+---
+
+*JEP-Agent SDK is released under BSD-3-Clause. The protocol draft is an individual IETF Internet-Draft and does not represent IETF endorsement.*

jep_agent_sdk-1.0.1/RELEASE-NOTES.md

@@ -0,0 +1,5 @@
+# Release 1.0.1
+
+Includes the reviewed September 2026 integrity, replay, persistence, async-lifecycle and compatibility repairs applicable to this repository. Wire/profile versions are unchanged unless explicitly described in the repository hardening notes.
+
+See HARDENING.md for supported verification scopes and migration boundaries. Registry publication and service deployment are reported by their workflows; a source merge alone is not a published package.

jep_agent_sdk-1.0.1/VERSION

@@ -0,0 +1 @@
+1.0.1