diff --git a/.gitignore b/.gitignore index 11ca1b3a..f207ead8 100644 --- a/.gitignore +++ b/.gitignore @@ -16,3 +16,4 @@ logs/ .flattened-pom.xml +samples/src/main/resources/spn_agent_credentials.json diff --git a/CHANGELOG.md b/CHANGELOG.md index 2e992c27..3803f5dd 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,6 +1,6 @@ # Changelog -## [Unreleased] +## [0.1.0] — 2026-09-18 - Send SSE heartbeat comments on streaming endpoints (`message:stream`, `tasks/{id}:subscribe`) at a configurable interval (`a2at.server.heartbeat-interval-seconds`, default 15 seconds, `0` disables). Keeps intermediaries @@ -11,6 +11,10 @@ `TaskResult`, `BusinessFailure`, and the message records). Source- and binary-compatible; callers that mutate the collections returned by these getters now receive `UnsupportedOperationException` instead of silently corrupting engine-owned snapshots. +- Template the sample OMC agent credentials file: the tracked + `samples/src/main/resources/spn_agent_credentials.json` is replaced by + `spn_agent_credentials.example.json` (real file is now git-ignored; copy the example to run the + demos). Missing credentials now fail with an actionable message instead of a bare NPE. ## [0.0.10] — 2026-09-16 @@ -35,7 +39,7 @@ carries no taskId. Invalid negotiation metadata on a bare message now fails explicitly instead of being silently treated as a normal successful response. - Converge non-functional formatting and javadoc drift between `main` and `dev` so the branches differ only in the - Eastcom platform integration. + instruction-platform integration. ## [0.0.8] — 2026-09-13 diff --git a/README.md b/README.md index 4792cfbf..b80412de 100644 --- a/README.md +++ b/README.md @@ -38,12 +38,12 @@ subscription remains open until the host-defined terminal event, explicit cancel ### 1. Add Maven dependency -The current engine release is `0.0.9` on [Maven Central](https://repo.maven.apache.org/maven2/net/openan/workflow/sdk/). +The current engine release is `0.1.0` on [Maven Central](https://repo.maven.apache.org/maven2/net/openan/workflow/sdk/). -A2A-T SDK `1.1.0` is published to Maven Central. Maven resolves it automatically; no SDK source checkout or local SDK +A2A-T SDK `1.1.1` is published to Maven Central. Maven resolves it automatically; no SDK source checkout or local SDK build is required. The engine depends only on -`a2a-t-core`; host agents using content generation explicitly add `a2a-t-client:1.1.0`. A dispatched-agent service that -validates received extension content adds `a2a-t-server:1.1.0`. See the bilingual +`a2a-t-core`; host agents using content generation explicitly add `a2a-t-client:1.1.1`. A dispatched-agent service that +validates received extension content adds `a2a-t-server:1.1.1`. See the bilingual [Developer Guide](docs/en/DEVELOPER_GUIDE.md) / [开发者指南](docs/zh/DEVELOPER_GUIDE.md) for dependency and upgrade guidance. @@ -51,7 +51,7 @@ upgrade guidance. net.openan.workflow.sdk workflow-engine - 0.0.9 + 0.1.0 ``` @@ -61,10 +61,19 @@ For Spring Boot server-side integration: net.openan.workflow.sdk spring-boot-starter - 0.0.9 + 0.1.0 ``` +### Agent credentials for the samples + +The sample demos read `samples/src/main/resources/spn_agent_credentials.json`, which is +git-ignored. Copy `spn_agent_credentials.example.json` to that name to run against the bundled +demo OMC — the checked-in defaults pair with the demo's embedded OMC server. When targeting a +real OMC, replace the endpoint and user name, and encrypt the password with `CredentialCrypto` +(set `A2AT_CRED_KEY`, then use the `enc:`-prefixed output). Tests use the tracked test resource +and need no setup. + ### 2. Execute a workflow The complete, compiled example is [HostQuickStart.java](samples/src/main/java/dev/openan/workflow/engine/examples/demo/HostQuickStart.java). diff --git a/config/checkstyle/checkstyle-suppressions.xml b/config/checkstyle/checkstyle-suppressions.xml index 2a015bbc..c5ed4116 100644 --- a/config/checkstyle/checkstyle-suppressions.xml +++ b/config/checkstyle/checkstyle-suppressions.xml @@ -20,18 +20,7 @@ - + - - - - - - + files="SpringSpnDemo\.java"/> diff --git a/config/spotbugs/spotbugs-exclude.xml b/config/spotbugs/spotbugs-exclude.xml index b2333041..b92aba14 100644 --- a/config/spotbugs/spotbugs-exclude.xml +++ b/config/spotbugs/spotbugs-exclude.xml @@ -79,15 +79,13 @@ - + - - - - - - - +