Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 6 additions & 3 deletions .github/scripts/check_package.py
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,8 @@ def check(root):
names = jar.namelist()
classes = [name for name in names if name.endswith(".class")]
require(classes, "SDK JAR has no classes")
require("com/qoder/cloudagents/ForwardClient.class" in names, "Missing Forward client")
for client in ("ForwardClient", "AsyncForwardClient", "ManagedClient", "AsyncManagedClient"):
require("com/qoder/cloudagents/" + client + ".class" in names, "Missing client: " + client)
require(jar.read("META-INF/LICENSE") == (root / "LICENSE").read_bytes(), "License differs")
properties = jar.read("com/qoder/cloudagents/version.properties").decode("utf-8")
require("version=" + version in properties.splitlines(), "Embedded version differs from POM")
Expand All @@ -47,9 +48,11 @@ def check(root):
or Path(name).name.startswith(".env") for name in names),
"Unexpected local or test data in SDK JAR")
with zipfile.ZipFile(jars[1]) as jar:
require("com/qoder/cloudagents/ForwardClient.java" in jar.namelist(), "Missing source attachment")
for client in ("ForwardClient", "ManagedClient"):
require("com/qoder/cloudagents/" + client + ".java" in jar.namelist(), "Missing source attachment: " + client)
with zipfile.ZipFile(jars[2]) as jar:
require("com/qoder/cloudagents/ForwardClient.html" in jar.namelist(), "Missing Javadoc attachment")
for client in ("ForwardClient", "ManagedClient"):
require("com/qoder/cloudagents/" + client + ".html" in jar.namelist(), "Missing Javadoc attachment: " + client)
require(not any(name.startswith("com/qoder/cloudagents/core/internal/") for name in jar.namelist()),
"Internal implementation leaked into public Javadoc")
files = jars + [pom]
Expand Down
4 changes: 4 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,10 @@

### Added

- Add `ManagedClient` / `AsyncManagedClient` and 108 documented Managed operations: Agents and versions, Deployments and Runs, Sessions/Threads/events/resources, Environments/self-hosted Work, Files, Skills/Versions, Vaults/Credentials/OAuth, Memory Stores, Models and Dreams.
- Add typed Managed budget and Credits, Agent runtime patches, versioned multiagent references, OSS storage, repository resources and exact Session provenance markers. Preserve null/omitted values and unknown response fields; retain POST search filters and opaque cursors.
- Add Managed independent JAR examples, opt-in CN/Global PAT/SA integration groups, official-response contract fixtures and API coverage documentation. Forward and Managed additions target one combined 0.2.0 release.

- Add typed synchronous/asynchronous Forward resource Search for Environments, Files, Skills and Vaults, retaining body filters, Identity query scope and Beta selectors across cursor pages.
- Add Forward Dream create/list/retrieve/cancel/archive, Channel Pairing list/retrieve/update, and Decision create/retrieve/list with typed input, output and precise score values.
- Add Identity auto-memory configuration, independent mount access and pagination, Schedule file resources, optional Run input snapshots, and Credits accessors for Session events.
Expand Down
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

The Qoder Cloud Agents Java SDK provides typed synchronous and asynchronous clients, with shared authentication, timeouts, retries, pagination, streaming and error handling.

Version **0.1.0** supports the **Forward API**. **Managed API support is planned for a future release** and is not available in this version.
Version **0.1.0** supports the **Forward API**. The development branch adds [Managed API support](docs/managed.md) for the planned combined **0.2.0** release; it is not available in the published 0.1.0 JAR.

| Capability | Resources |
| --- | --- |
Expand All @@ -18,7 +18,7 @@ Version **0.1.0** supports the **Forward API**. **Managed API support is planned

See [API coverage and resource guides](docs/forward-api-coverage.md) for the supported operations.

The development branch also includes [Forward Search, Dreams, Decisions, pairing management and contract updates](docs/forward-parity.md), alongside Webhooks and client extensions. These additions are unreleased and are not included in the published `0.1.0` JAR.
The development branch also includes [Forward Search, Dreams, Decisions, pairing management and contract updates](docs/forward-parity.md), alongside Webhooks, client extensions and [108 Managed operations](docs/managed-api-coverage.md). These additions are unreleased and are not included in the published `0.1.0` JAR.

- [Installation](#installation)
- [Quick start](#quick-start)
Expand Down
2 changes: 1 addition & 1 deletion docs/forward-parity.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Forward API additions (unreleased)

This guide describes the development SDK after `0.1.0`, checked against the official Forward documentation on 2026-10-28. These additions are not available from the published `0.1.0` JAR. Both `ForwardClient` and `AsyncForwardClient` expose the same resources, including `withResponse()` for status, headers and request IDs. Managed remains a separate future scope.
This guide describes the development SDK after `0.1.0`, checked against the official Forward documentation on 2026-10-28. These additions are not available from the published `0.1.0` JAR. Both `ForwardClient` and `AsyncForwardClient` expose the same resources, including `withResponse()` for status, headers and request IDs. The same planned 0.2.0 release also includes [Managed support](managed.md).

## Search resources

Expand Down
2 changes: 1 addition & 1 deletion docs/maintaining.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Java SDK maintenance

The SDK covers Forward and targets Java 8. Use JDK 17 or later for maintenance tools; the runtime compatibility matrix remains Java 8, 11, 17, 21 and 25.
The development SDK covers Forward and Managed and targets Java 8. Use JDK 17 or later for maintenance tools; the runtime compatibility matrix remains Java 8, 11, 17, 21 and 25.

## Local checks and pull requests

Expand Down
Loading
Loading