Skip to content

Commit 9967ea4

Browse files
authored
docs: pin orchestrator v4.0.2 in hosted-agent release matrix (#649)
Orchestrator v4.0.2 (commit c653b3ec0a553f55244e197f3be993ad33ffe02f) ships PR #313, forcing store: false unconditionally on every hosted POST /responses call and returning HTTP 422 for background: true. Updates the exact integrated matrix table, stateless-runtime-contract version reference, and the store-false wire contract warning to record the released fix and re-pin, while keeping validation-pending status until the network-isolated store unset/true/false matrix is re-run live. Also updates the continuity platform contract page's pin reference.
1 parent c683102 commit 9967ea4

2 files changed

Lines changed: 27 additions & 23 deletions

File tree

docs/hosted_agent_release_matrix.md

Lines changed: 24 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ that remain fail closed.
2929
| Component | Release | Reviewed release commit | Relevant contract |
3030
| --- | --- | --- | --- |
3131
| GPT-RAG UI | [`v2.6.0`](https://github.com/Azure/gpt-rag-ui/releases/tag/v2.6.0) | [`81d6515`](https://github.com/Azure/gpt-rag-ui/commit/81d6515d8fc365402e958e861b671af037a4cc75) | Hosted/no-panel is the fresh UI default when `CHAT_BACKEND` is absent; continuity and panel surfaces remain opt-in and fail closed. |
32-
| GPT-RAG orchestrator | [`v4.0.1`](https://github.com/Azure/gpt-rag-orchestrator/releases/tag/v4.0.1) | [`7e22840`](https://github.com/Azure/gpt-rag-orchestrator/commit/7e22840ba0e96a5ce237cf2657795768f88e3955) | Canonical hosted `/responses` is stateless and requires caller-supplied ordered input. Fixes the `dependencies`/`connectors` circular import that crashed the hosted entrypoint on startup ([PR #311](https://github.com/Azure/gpt-rag-orchestrator/pull/311)). |
32+
| GPT-RAG orchestrator | [`v4.0.2`](https://github.com/Azure/gpt-rag-orchestrator/releases/tag/v4.0.2) | [`c653b3e`](https://github.com/Azure/gpt-rag-orchestrator/commit/c653b3ec0a553f55244e197f3be993ad33ffe02f) | Canonical hosted `/responses` is stateless and requires caller-supplied ordered input. Fixes the `dependencies`/`connectors` circular import that crashed the hosted entrypoint on startup ([PR #311](https://github.com/Azure/gpt-rag-orchestrator/pull/311)), released in `v4.0.1`. Unconditionally forces `store: false` on every hosted `POST /responses` call and rejects `background: true` with HTTP 422 ([PR #313](https://github.com/Azure/gpt-rag-orchestrator/pull/313)), released in `v4.0.2`; see "Store false wire contract" below — this closes the code gap but the live network-isolated re-run remains pending. |
3333
| GPT-RAG ingestion | [`v2.7.0`](https://github.com/Azure/gpt-rag-ingestion/releases/tag/v2.7.0) | [`84b9277`](https://github.com/Azure/gpt-rag-ingestion/commit/84b927769ef0839110f2d68e3ca471e2260567cf) | Metadata-only operator overview and document/corpus curation APIs. |
3434
| AI Landing Zone | [`v2.5.1`](https://github.com/Azure/bicep-ptn-aiml-landing-zone/releases/tag/v2.5.1) | [`9cc5859`](https://github.com/Azure/bicep-ptn-aiml-landing-zone/commit/9cc5859af5c8ab3b31709c9e16e0db11a170a404) | Two-phase hosted-agent prerequisite/handoff support; both hosted flags default to `false`. Also allows the Foundry Agent Service's `agent365.svc.cloud.microsoft` observability endpoint through Azure Firewall under network isolation (`v2.5.1`, patch). |
3535

@@ -63,7 +63,7 @@ remove them and then assume the UI fallback values are equivalent.
6363

6464
## Stateless hosted runtime contract
6565

66-
Orchestrator `v4.0.1` performs no managed-Conversations create, read, append, or
66+
Orchestrator `v4.0.2` performs no managed-Conversations create, read, append, or
6767
delete operation in the hosted container. The caller supplies the complete,
6868
bounded, oldest-to-newest history on every request.
6969

@@ -100,36 +100,39 @@ the UI call route with the protocol and role evidence it validates.
100100

101101
## Store false wire contract
102102

103-
!!! warning "Additional confirmed gap; fix pending release and re-pin"
104-
Exact-matrix live validation against a network-isolated deployment showed
105-
that `POST /responses` succeeds when the caller sends `store: false`, but
106-
an **omitted or `true`** `store` deterministically fails with a platform
107-
`storage_error`. Root cause: the pinned
103+
!!! warning "Gap fixed and pinned; live network-isolated re-run still pending"
104+
A prior exact-matrix live validation against a network-isolated deployment
105+
showed that `POST /responses` succeeded when the caller sent
106+
`store: false`, but an **omitted or `true`** `store` deterministically
107+
failed with a platform `storage_error`. Root cause: the pinned
108108
`azure-ai-agentserver-responses==2.0.0b1` host auto-activates its own
109109
network-bound Foundry storage provider whenever the process detects it is
110110
running as a hosted agent and no explicit `store` override is supplied —
111111
true of every real deployment — and only calls that provider when the
112112
**caller's** `store` is true (an omitted `store` defaults to `true` per the
113113
Responses contract). Orchestrator `v4.0.1`'s already-stateless design
114-
(previous section) hardcodes `store: False` only on the *separate, inner*
115-
call the hosted strategy makes to the model; it does not touch the
114+
(previous section) hardcoded `store: False` only on the *separate, inner*
115+
call the hosted strategy makes to the model; it did not touch the
116116
*outer*, wire-level `store` field on the incoming request, which is the
117117
one the auto-activated provider reads.
118118

119-
A fix that forces `store: False` unconditionally on every hosted
119+
The fix that forces `store: False` unconditionally on every hosted
120120
`POST /responses` call — regardless of what a caller sends or omits, for
121121
both streaming and non-streaming requests, and rejecting
122-
`background: true` (which requires `store: true` in the pinned SDK) — is
123-
proposed in
124-
[orchestrator PR #313](https://github.com/Azure/gpt-rag-orchestrator/pull/313).
125-
That PR is **open, not yet released, and not yet pinned** by this
126-
umbrella's `manifest.json`, which still pins orchestrator `v4.0.1`
127-
(the version with the gap). Do not describe the store contract as fixed,
128-
validated, or safe under network isolation until: the PR is reviewed and
129-
released; the umbrella manifest is re-pinned to the released version; and
130-
the exact matrix (`store` unset / `true` / `false`, under
131-
`NETWORK_ISOLATION=true`, streaming and non-streaming) is re-run live and
132-
passes. This warning must remain until that re-run is recorded here.
122+
`background: true` with HTTP 422 (it requires `store: true` in the pinned
123+
SDK) — merged as
124+
[orchestrator PR #313](https://github.com/Azure/gpt-rag-orchestrator/pull/313)
125+
and released as
126+
[`v4.0.2`](https://github.com/Azure/gpt-rag-orchestrator/releases/tag/v4.0.2)
127+
(commit
128+
[`c653b3e`](https://github.com/Azure/gpt-rag-orchestrator/commit/c653b3ec0a553f55244e197f3be993ad33ffe02f),
129+
722 tests passing upstream). This umbrella's `manifest.json` now pins that
130+
released commit. **This is a code-level fix and re-pin, not yet a live
131+
re-validation.** Do not describe the store contract as validated or safe
132+
under network isolation until the exact matrix (`store` unset / `true` /
133+
`false`, under `NETWORK_ISOLATION=true`, streaming and non-streaming) is
134+
re-run live against this pin and passes. This warning must remain until
135+
that re-run is recorded here.
133136

134137
## Delegated owner binding
135138

docs/hosted_continuity_platform_contract.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,10 +10,11 @@ preferred and default continuity architecture.
1010
The OQ-OWN platform pivot merged in
1111
[PR #633](https://github.com/Azure/GPT-RAG/pull/633) at
1212
[`86b17b0`](https://github.com/Azure/GPT-RAG/commit/86b17b0af672edefe6842cba0f1a8ff77ab23038),
13-
and the umbrella integration now pins UI `v2.6.0`, orchestrator `v4.0.1`,
13+
and the umbrella integration now pins UI `v2.6.0`, orchestrator `v4.0.2`,
1414
ingestion `v2.7.0`, and AILZ `v2.5.1` at their exact release commits. See
1515
[the hosted-agent component release matrix](hosted_agent_release_matrix.md#store-false-wire-contract)
16-
for a still-open `/responses` `store` gap and its pending fix.
16+
for the `/responses` `store` gap, now fixed and pinned but still pending
17+
live network-isolated re-validation.
1718
Keep `HOSTED_CONTINUITY_ENABLED=false` until deployment proves the exact
1819
owner-binding role and protocol contract and records
1920
`HOSTED_CONVERSATION_OWNER_BINDING_VALIDATED=true`, continuity endpoints

0 commit comments

Comments
 (0)