[Python] Durable thread compaction and history providers (ADR 0032) - #59

Draft

Ahmed Muhsin (ahmedmuhsin) wants to merge 32 commits into

mainfrom

python/durable-thread-compaction

Commits on Jul 31, 2026

docs: add ADR 0032 for durable thread compaction
Ahmed Muhsin (ahmedmuhsin)
committed
3be2a20
feat: back durable agent history with a core HistoryProvider (ADR 0032)
Ahmed Muhsin (ahmedmuhsin)
committed
63604bc
feat: forward workflow conversation context to durable agents (ADR 0032 L3)
Ahmed Muhsin (ahmedmuhsin)
committed
9a2dfc3
feat: back registered agents with durable history automatically (ADR 0032)
Ahmed Muhsin (ahmedmuhsin)
committed
d205416
fix: correct history ownership for external and service-managed agents; add prune_history
Ahmed Muhsin (ahmedmuhsin)
committed
406611d
feat: extend prune_history and workflow context forwarding to the Functions host
Ahmed Muhsin (ahmedmuhsin)
committed
4639bd4
refactor: remove duplicated host-adapter logic and enforce the context protocol on both hosts
Ahmed Muhsin (ahmedmuhsin)
committed
62b6ce3
chore: ignore local .env files
Ahmed Muhsin (ahmedmuhsin)
committed
c3bf401
fix: honor explicit store option and give history providers a stable session id
Ahmed Muhsin (ahmedmuhsin)
committed
72fab1c
docs: record history-ownership rules and entity lifetime concerns in ADR 0032
Ahmed Muhsin (ahmedmuhsin)
committed
af5798a
test: add samples and integration coverage for durable history and compaction
Ahmed Muhsin (ahmedmuhsin)
committed
3ddb589
feat: persist the agent session so provider state survives across turns
Ahmed Muhsin (ahmedmuhsin)
committed
29198bd
fix: restore session state values as their own types after a cold start
Ahmed Muhsin (ahmedmuhsin)
committed
7e7a821
docs: sharpen ADR 0032's account of the store-side compaction gap
Ahmed Muhsin (ahmedmuhsin)
committed
0775b58
docs: complete the record of deferred core gaps in ADR 0032
Ahmed Muhsin (ahmedmuhsin)
committed
cc74aff
docs: tighten ADR 0032 for coherence and length
Ahmed Muhsin (ahmedmuhsin)
committed
36b7fda
docs: drop em dashes and prose semicolons from this branch's content
Ahmed Muhsin (ahmedmuhsin)
committed
23f9aaa
docs: revert ADR 0032 to proposed and clear deciders/consulted
Ahmed Muhsin (ahmedmuhsin)
committed
c63cef7
test: cover the persisted session in integration, and fix two tests that could not fail
Ahmed Muhsin (ahmedmuhsin)
committed
b868498
fix: satisfy mypy on the tests, which CI runs and I did not
Ahmed Muhsin (ahmedmuhsin)
committed
ebad2f0
fix: make the redis lrange result typing environment independent
Ahmed Muhsin (ahmedmuhsin)
committed
56c29c0
fix: keep compaction reconciliation correct when messages shift or repeat
Ahmed Muhsin (ahmedmuhsin)
committed
002b9ef
fix: derive synthesized message ids from persisted state, not object identity
Ahmed Muhsin (ahmedmuhsin)
committed
1f38a6b
fix: put the new samples on Foundry, which is what CI provisions
Ahmed Muhsin (ahmedmuhsin)
committed
65507c9
fix: close four defects review found in the entity's context and session handling
Ahmed Muhsin (ahmedmuhsin)
committed
8a6de7e

Commits on Aug 13, 2026

docs: rework ADR 0032 around capacity, and correct what review found wrong
Ahmed Muhsin (ahmedmuhsin)
committed
423d846

Navigation Menu

Uh oh!

[Python] Durable thread compaction and history providers (ADR 0032) - #59

[Python] Durable thread compaction and history providers (ADR 0032)#59
Ahmed Muhsin (ahmedmuhsin) wants to merge 32 commits into
mainfrom
python/durable-thread-compaction

Commits on Jul 31, 2026

docs: add ADR 0032 for durable thread compaction

feat: back durable agent history with a core HistoryProvider (ADR 0032)

feat: forward workflow conversation context to durable agents (ADR 0032 L3)

feat: back registered agents with durable history automatically (ADR 0032)

fix: correct history ownership for external and service-managed agents; add prune_history

feat: extend prune_history and workflow context forwarding to the Functions host

refactor: remove duplicated host-adapter logic and enforce the context protocol on both hosts

chore: ignore local .env files

fix: honor explicit store option and give history providers a stable session id

docs: record history-ownership rules and entity lifetime concerns in ADR 0032

test: add samples and integration coverage for durable history and compaction

feat: persist the agent session so provider state survives across turns

fix: restore session state values as their own types after a cold start

docs: sharpen ADR 0032's account of the store-side compaction gap

docs: complete the record of deferred core gaps in ADR 0032

docs: tighten ADR 0032 for coherence and length

docs: drop em dashes and prose semicolons from this branch's content

docs: revert ADR 0032 to proposed and clear deciders/consulted

test: cover the persisted session in integration, and fix two tests that could not fail

fix: satisfy mypy on the tests, which CI runs and I did not

fix: make the redis lrange result typing environment independent

fix: keep compaction reconciliation correct when messages shift or repeat

fix: derive synthesized message ids from persisted state, not object identity

fix: put the new samples on Foundry, which is what CI provisions

fix: close four defects review found in the entity's context and session handling

Commits on Aug 13, 2026

docs: rework ADR 0032 around capacity, and correct what review found wrong

Commits on Aug 14, 2026

feat: bound durable entity state so an agent stops failing at the backend limit

feat: make workflow duplicate detection survive retention, and declare what we persist

test: drive retention through the real entity, and document the modes

docs: settle whether blob offload can reach the Durable Functions Python path

docs: tighten ADR 0032 around the actual decision

refactor: remove the unshipped prune_history alias