{"id":"openai-agents-sdk-memory--openai-github-io","name":"OpenAI Agents SDK Memory","url":"https://openai.github.io/openai-agents-python/ref/memory/","page":"https://mrpeppersdev.github.io/agent-infrastructure-landscape/systems/openai-agents-sdk-memory--openai-github-io","family":"memory","section":"Framework-embedded memory","sections":["Framework-embedded memory"],"tier":2,"last_verified_at":"2026-10-22","lifecycle":{"status":"active","severity":0,"note":null},"taxonomy":{"storage":[{"value":"kv","primary":true,"reason":null},{"value":"vector","primary":false,"reason":null}],"retrieval":[{"value":"injection","primary":true,"reason":null},{"value":"similarity","primary":false,"reason":null}],"persistence":[{"value":"cross-session","primary":true,"reason":null}],"update":[{"value":"overwrite","primary":true,"reason":null},{"value":"extraction","primary":false,"reason":null}],"unit":[{"value":"episode","primary":true,"reason":null},{"value":"fact","primary":false,"reason":null}],"governance":[{"value":"inspectable","primary":true,"reason":null}],"conflict":[{"value":"overwrite","primary":true,"reason":null}]},"cells":{"type":{"value":"Sessions + RunContextWrapper + categorised long-term","citation":"https://openai.github.io/openai-agents-python/ref/memory/","status":"real-data","tier":"T2","source_class":"vendor"},"desc":{"value":"OpenAI's agent SDK. Sessions for working context within an agent loop; RunContextWrapper for structured persistent state. April 2026 update added categorised long-term memory: project / user / policy. Long-term tier typically backed by external vector DBs (Pinecone, etc.).","citation":"https://openai.github.io/openai-agents-python/ref/memory/","status":"real-data","tier":"T2","source_class":"vendor"},"claims":{"value":"Sessions-based working-context layer over Responses API; SDK handles context length, history, and continuity automatically. Storage backends: SQLite (default), SQLAlchemy (production), Dapr, OpenAI Conversations API. Compaction via OpenAIResponsesCompactionSession. April 2026 added categorised long-term memory (project / user / policy)","citation":"https://openai.github.io/openai-agents-python/sessions/","status":"real-data","tier":"T2","source_class":"vendor"},"modalities":{"value":"text","citation":"https://openai.github.io/openai-agents-python/ref/memory/","status":"real-data","tier":"T2","source_class":"vendor"},"created":{"value":"2025-03 (launched March 2025 as production-ready evolution of Swarm)","citation":"https://openai.com/index/new-tools-for-building-agents/","status":"real-data","tier":"T2","last_verified_at":"2026-05-12","source_class":"vendor"},"latest-release":{"value":"v0.24.0 (2026-10-15)","citation":"https://pypi.org/project/openai-agents/","status":"real-data","tier":"T2","last_verified_at":"2026-10-22","source_class":"registry"},"license":{"value":"MIT","citation":"https://pypi.org/project/openai-agents/","status":"real-data","tier":"T2","source_class":"registry"},"gh":{"value":"openai/openai-agents-python — ~28.6k stars","citation":"https://github.com/openai/openai-agents-python","status":"real-data","tier":"T1","last_verified_at":"2026-10-22","source_class":"repo"},"mindshare":{"value":"n/a (no standalone pkg) 2 press n/a (OpenAI sub jobs","citation":"https://openai.github.io/openai-agents-python/ref/memory/","status":"not-applicable","tier":"T2","last_verified_at":"2026-05-12","source_class":"vendor"},"citations":{"value":"not applicable — not academic","citation":null,"status":"not-applicable","tier":"T3","last_verified_at":"2026-05-06"},"funding":{"value":"OpenAI raised $40B+ total funding across multiple rounds; $300B+ valuation; no independent funding for SDK","citation":"https://openai.com/","status":"real-data","tier":"T2","last_verified_at":"2026-05-12","source_class":"vendor"},"customers":{"value":"searched not found","citation":"https://openai.github.io/openai-agents-python/ref/memory/","status":"depth-floor-reached","tier":"T2","source_class":"vendor"},"pricing":{"value":"SDK OSS free; pay for OpenAI API model usage at standard token pricing (e.g. GPT-5.4: $2.50/$15 per M tokens)","citation":"https://openai.com/api/pricing/","status":"real-data","tier":"T2","source_class":"vendor"},"compliance":{"value":"OpenAI enterprise plans: SOC 2 Type II, GDPR, HIPAA BAA available; Azure OpenAI adds government/FedRAMP compliance","citation":"https://openai.com/security/","status":"real-data","tier":"T2","source_class":"vendor"},"data-handling":{"value":"Enterprise/API: data not used for training by default; encrypted in transit/at rest","citation":"https://openai.com/security/","status":"real-data","tier":"T2","source_class":"vendor"},"deployment":{"value":"Both (OSS library self-hosted; relies on OpenAI or Azure OpenAI API endpoints; no dedicated SDK hosting)","citation":"https://openai.github.io/openai-agents-python/","status":"real-data","tier":"T2","source_class":"vendor"},"hq":{"value":"US (San Francisco, CA)","citation":"https://openai.com/","status":"real-data","tier":"T2","source_class":"vendor"},"founders":{"value":"OpenAI; corporate product (Sam Altman CEO; Greg Brockman; ex-OpenAI researchers)","citation":"https://openai.github.io/openai-agents-python/ref/memory/","status":"real-data","tier":"T2","source_class":"vendor"},"volume":{"value":"no scale claim","citation":"https://openai.github.io/openai-agents-python/ref/memory/","status":"real-data","tier":"T2","source_class":"vendor"},"perf":{"value":"no public benchmark scores found","citation":"https://openai.github.io/openai-agents-python/ref/memory/","status":"depth-floor-reached","tier":"T2","source_class":"vendor"},"repro":{"value":"not applicable — not a research paper","citation":null,"status":"not-applicable","tier":"T3"},"code-release":{"value":"not applicable — not a research paper","citation":null,"status":"not-applicable","tier":"T3"},"api-surface":{"value":"REST, SDK: Python, JS/TS","citation":"https://platform.openai.com/docs/guides/agents-sdk","status":"real-data","tier":"T2","source_class":"vendor"},"latency":{"value":"searched not found","citation":"https://platform.openai.com/docs/guides/agents-sdk","status":"depth-floor-reached","tier":"T2","source_class":"vendor"},"throughput":{"value":"searched not found","citation":"https://platform.openai.com/docs/guides/agents-sdk","status":"depth-floor-reached","tier":"T2","source_class":"vendor"},"backend-storage":{"value":"custom (OpenAI-managed)","citation":"https://platform.openai.com/docs/guides/agents-sdk","status":"real-data","tier":"T2","source_class":"vendor"},"multi-tenancy":{"value":"hard-isolation","citation":"https://openai.com/security","status":"real-data","tier":"T2","source_class":"vendor"},"encryption":{"value":"at-rest + in-transit","citation":"https://openai.com/security","status":"real-data","tier":"T2","source_class":"vendor"},"sso-rbac":{"value":"SSO + RBAC","citation":"https://openai.com/enterprise","status":"real-data","tier":"T2","source_class":"vendor"},"embedding-model":{"value":"multiple supported","citation":"https://platform.openai.com/docs/guides/embeddings","status":"real-data","tier":"T2","source_class":"vendor"},"consistency":{"value":"not specified - vendor docs do not address this dimension","citation":"https://openai.github.io/openai-agents-python/ref/memory/","status":"depth-floor-reached","tier":"T2","source_class":"vendor"},"versioning":{"value":"not specified - vendor docs do not address this dimension","citation":"https://openai.github.io/openai-agents-python/ref/memory/","status":"depth-floor-reached","tier":"T2","source_class":"vendor"},"tombstoning":{"value":"not specified - vendor docs do not address this dimension","citation":"https://openai.github.io/openai-agents-python/ref/memory/","status":"depth-floor-reached","tier":"T2","source_class":"vendor"},"schema-evolution":{"value":"not specified - vendor docs do not address this dimension","citation":"https://openai.github.io/openai-agents-python/ref/memory/","status":"depth-floor-reached","tier":"T2","source_class":"vendor"},"namespace":{"value":"per-tenant","citation":"https://openai.github.io/openai-agents-python/ref/memory/","status":"real-data","tier":"T2","source_class":"vendor"},"contradiction":{"value":"always overwrite (last-write-wins)","citation":"https://openai.github.io/openai-agents-python/ref/memory/","status":"real-data","tier":"T2","source_class":"vendor"},"forgetting":{"value":"not specified - vendor docs do not address this dimension","citation":"https://openai.github.io/openai-agents-python/ref/memory/","status":"depth-floor-reached","tier":"T2","source_class":"vendor"},"mcp-support":{"value":"native (first-party) — Agents SDK MCP support","citation":"https://openai.github.io/openai-agents-python/mcp/","status":"real-data","tier":"T2","source_class":"vendor"},"a2a-support":{"value":"searched not found","citation":"https://openai.github.io/openai-agents-python/ref/memory/","status":"depth-floor-reached","tier":"T2","source_class":"vendor"},"otel":{"value":"via adapter — OpenAI traces + OTel exporters","citation":"https://openai.github.io/openai-agents-python/tracing/","status":"real-data","tier":"T2","source_class":"vendor"},"webhooks":{"value":"searched not found","citation":"https://openai.github.io/openai-agents-python/ref/memory/","status":"depth-floor-reached","tier":"T2","source_class":"vendor"},"import-export":{"value":"JSON via Responses / threads API","citation":"https://platform.openai.com/docs/api-reference","status":"real-data","tier":"T2","source_class":"vendor"},"integration-count":{"value":"0","citation":"https://openai.github.io/openai-agents-python/ (Pinecone outbound; 0 catalog inbound)","status":"real-data","tier":"T2","source_class":"vendor"},"orchestration":{"value":"both (single Agent + handoffs/multi-agent runs; session-scoped memory)","citation":"https://openai.github.io/openai-agents-python/sessions/","status":"real-data","tier":"T2","source_class":"vendor"},"programmatic-control":{"value":"full CRUD via Python/JS SDK","citation":"https://openai.github.io/openai-agents-python/ref/","status":"real-data","tier":"T2","source_class":"vendor"},"vendor-benchmarks":{"value":"searched not found","citation":"https://openai.github.io/openai-agents-python/","status":"depth-floor-reached","tier":"T2","last_verified_at":"2026-05-12","source_class":"vendor"},"pricing-specifics":{"value":"SDK OSS free; pay OpenAI API (e.g. GPT-5.4 $2.50/$15 per M tokens) — per-token-stored","citation":"https://openai.com/api/pricing/","status":"real-data","tier":"T2","source_class":"vendor"},"agent-abstraction":{"value":"ReAct (Sessions + RunContext)","citation":"https://openai.github.io/openai-agents-python/ref/memory/","status":"real-data","tier":"T2","source_class":"vendor"},"memory-primitives":{"value":"multiple (Sessions working + categorised long-term project/user/policy + external vector)","citation":"https://openai.github.io/openai-agents-python/ref/memory/","status":"real-data","tier":"T2","source_class":"vendor"},"llm-lock":{"value":"single-vendor (OpenAI; OpenAI-Compatible adapters possible)","citation":"https://openai.github.io/openai-agents-python/","status":"real-data","tier":"T2","source_class":"vendor"},"runtimes":{"value":"Python, Node/TypeScript","citation":"https://github.com/openai/openai-agents-js","status":"real-data","tier":"T1","source_class":"repo"},"session-handling":{"value":"sticky session + persistent thread","citation":"https://openai.github.io/openai-agents-python/ref/memory/","status":"real-data","tier":"T2","source_class":"vendor"},"validated-verticals":{"value":"OpenAI enterprise + developers (horizontal)","citation":"https://openai.github.io/openai-agents-python/","status":"real-data","tier":"T2","source_class":"vendor"},"time-to-running":{"value":"<10min (pip install + OpenAI key)","citation":"https://openai.github.io/openai-agents-python/","status":"real-data","tier":"T2","source_class":"vendor"},"anti-fit":{"value":"not for non-OpenAI providers (provider-coupled)","citation":"https://openai.github.io/openai-agents-python/","status":"real-data","tier":"T2","source_class":"vendor"},"optimised-for":{"value":"OpenAI-native agent SDK with Sessions + categorised memory","citation":"https://openai.github.io/openai-agents-python/","status":"real-data","tier":"T2","source_class":"vendor"},"adjacent-infrastructure":{"value":"requires OpenAI API; BYO persistence layer","citation":"https://openai.github.io/openai-agents-python/","status":"real-data","tier":"T2","source_class":"vendor"},"pros":{"value":"First-party from OpenAI — fastest path if you're building exclusively on OpenAI models.","citation":"https://openai.github.io/openai-agents-python/ref/memory/","status":"real-data","tier":"T2","source_class":"vendor"},"cons":{"value":"Vendor-locked; less feature surface than dedicated memory layers.","citation":"https://openai.github.io/openai-agents-python/ref/memory/","status":"real-data","tier":"T2","source_class":"vendor"},"links":{"value":"SDK home memory reference April 2026 update cookbook: long-term notes","citation":"https://openai.github.io/openai-agents-python/ref/memory/","status":"real-data","tier":"T2","source_class":"vendor"},"obs-langsmith":{"value":"","citation":null,"status":"no-data","tier":"T3","last_verified_at":"2026-05-14"},"obs-opentelemetry":{"value":"","citation":null,"status":"no-data","tier":"T3","last_verified_at":"2026-05-14"},"obs-datadog":{"value":"","citation":null,"status":"no-data","tier":"T3","last_verified_at":"2026-05-14"},"obs-helicone":{"value":"","citation":null,"status":"no-data","tier":"T3","last_verified_at":"2026-05-14"},"obs-weave":{"value":"","citation":null,"status":"no-data","tier":"T3","last_verified_at":"2026-05-14"},"obs-langfuse":{"value":"","citation":null,"status":"no-data","tier":"T3","last_verified_at":"2026-05-14"},"obs-arize":{"value":"","citation":null,"status":"no-data","tier":"T3","last_verified_at":"2026-05-14"},"obs-custom":{"value":"","citation":null,"status":"no-data","tier":"T3","last_verified_at":"2026-05-14"},"cost-token-budget":{"value":"","citation":null,"status":"no-data","tier":"T3","last_verified_at":"2026-05-14"},"cost-prompt-caching":{"value":"","citation":null,"status":"no-data","tier":"T3","last_verified_at":"2026-05-14"},"cost-semantic-caching":{"value":"","citation":null,"status":"no-data","tier":"T3","last_verified_at":"2026-05-14"},"cost-batching":{"value":"","citation":null,"status":"no-data","tier":"T3","last_verified_at":"2026-05-14"},"cost-model-routing":{"value":"","citation":null,"status":"no-data","tier":"T3","last_verified_at":"2026-05-14"},"cost-streaming-only":{"value":"","citation":null,"status":"no-data","tier":"T3","last_verified_at":"2026-05-14"},"cost-observability-cost-attribution":{"value":"","citation":null,"status":"no-data","tier":"T3","last_verified_at":"2026-05-14"},"eval-langsmith-evals":{"value":"","citation":null,"status":"no-data","tier":"T3","last_verified_at":"2026-05-14"},"eval-braintrust":{"value":"","citation":null,"status":"no-data","tier":"T3","last_verified_at":"2026-05-14"},"eval-weights-and-biases-agent":{"value":"","citation":null,"status":"no-data","tier":"T3","last_verified_at":"2026-05-14"},"eval-helicone-evals":{"value":"","citation":null,"status":"no-data","tier":"T3","last_verified_at":"2026-05-14"},"eval-custom-test-harness":{"value":"","citation":null,"status":"no-data","tier":"T3","last_verified_at":"2026-05-14"},"eval-human-loop":{"value":"","citation":null,"status":"no-data","tier":"T3","last_verified_at":"2026-05-14"},"eval-production-traffic-replay":{"value":"","citation":null,"status":"no-data","tier":"T3","last_verified_at":"2026-05-14"},"commit-trajectory":{"value":"not applicable — no GitHub repo","citation":null,"status":"not-applicable","tier":"T3","last_verified_at":"2026-05-14"},"citation-trajectory":{"value":"not applicable — non-paper row","citation":null,"status":"not-applicable","tier":"T3","last_verified_at":"2026-05-14"},"download-trajectory":{"value":"not applicable — not published as a package","citation":null,"status":"not-applicable","tier":"T3","last_verified_at":"2026-05-14"},"cost-input-usd-per-mtok":{"value":"2.50","citation":null,"status":"estimate","tier":"T3"},"cost-output-usd-per-mtok":{"value":"15","citation":null,"status":"estimate","tier":"T3"},"cost-tier":{"value":"premium","citation":null,"status":"estimate","tier":"T3"},"cost-pricing-model":{"value":"per-token","citation":null,"status":"estimate","tier":"T3"},"cost-last-verified":{"value":"2026-06-29","citation":null,"status":"estimate","tier":"T3"},"capability-composite-score":{"value":"74","citation":null,"status":"estimate","tier":"T3"},"capability-band":{"value":"competent","citation":null,"status":"estimate","tier":"T3"},"capability-benchmark-sources":{"value":"general capability estimate — no specific memory benchmark recalled, builds on Responses API","citation":null,"status":"estimate","tier":"T3"},"capability-last-verified":{"value":"2026-06-29","citation":null,"status":"estimate","tier":"T3"},"use-case-tags":{"value":"scoped-agentic, long-running-session, memory-augmented-chat, multi-agent-coordination","citation":null,"status":"estimate","tier":"T3"},"use-case-anti-tags":{"value":"offline-capable","citation":null,"status":"estimate","tier":"T3"},"adoption-accelerator":{"value":"","citation":null,"status":"no-data","tier":"T3"},"architecture-deployment-locus":{"value":"local","citation":"https://openai.github.io/openai-agents-python/","status":"real-data","tier":"T2","source_class":"vendor"},"licensing-bucket":{"value":"open-source","citation":"https://pypi.org/project/openai-agents/","status":"real-data","tier":"T2","source_class":"registry"},"positioning-platform-vs-product":{"value":"platform","citation":"https://openai.github.io/openai-agents-python/","status":"real-data","tier":"T2","source_class":"vendor"},"taxonomy-three-layer-rollup":{"value":"agent-infra","citation":"https://github.com/MrPeppersDev/agent-infrastructure-landscape/blob/main/docs/schema/section-to-three-layer-rollup.json","status":"real-data","tier":"T1","source_class":"repo"},"developer-activity-opendigger":{"value":"{\"activity\":434.56,\"as_of\":\"2026-09\",\"openrank_12mo\":29.19,\"openrank_current\":22.9,\"participants\":153}","citation":"https://oss.open-digger.cn/github/openai/openai-agents-python/openrank.json","status":"real-data","tier":"T2","last_verified_at":"2026-10-28","source_class":"third-party"},"freshness-date":{"value":"2026-10-22","citation":"https://mrpeppersdev.github.io/agent-infrastructure-landscape/systems/openai-agents-sdk-memory--openai-github-io","status":"real-data","tier":"T2","source_class":"catalog"},"compliance-certifications":{"value":"not applicable — no hosted service","citation":"https://github.com/openai/openai-agents-python","status":"not-applicable","tier":"T1","source_class":"repo"},"sdk-languages":{"value":"python,typescript","citation":"https://github.com/openai/openai-agents-python","status":"real-data","tier":"T1","source_class":"repo"},"protocol-support":{"value":"mcp-client","citation":"https://openai.github.io/openai-agents-python/mcp/","status":"real-data","tier":"T2","source_class":"vendor"},"maturity":{"value":"","citation":null,"status":"no-data","tier":"T3"}},"corroboration":{"cited_cells":51,"third_party_cells":1},"edges":{"outgoing":[{"source":"openai-agents-sdk-memory--openai-github-io","target":"openai-gpt-family-gpt-5-gpt-4o-o3-o4--openai-com","type":"runtime-dependency","evidence":"adjacent-infrastructure cell: requires OpenAI API; BYO persistence layer","citation":"https://openai.github.io/openai-agents-python/"},{"source":"openai-agents-sdk-memory--openai-github-io","target":"pinecone--pinecone-io","type":"built-on","evidence":"Long-term tier typically backed by external vector DBs (Pinecone, etc.).","citation":"https://openai.github.io/openai-agents-python/ref/memory/"}],"incoming":[]},"history":[{"date":"2026-10-22","commit":"89dcc719ed","pr":195,"kind":"update","changes":[{"field":"license","label":"License","from":"not applicable — not OSS","to":"MIT","source":"https://pypi.org/project/openai-agents/"},{"field":"latest-release","label":"Latest release","from":"not applicable — not OSS","to":"v0.24.0 (2026-10-15)","source":"https://pypi.org/project/openai-agents/"}]}],"license":"CC-BY-4.0","source":"https://github.com/MrPeppersDev/agent-infrastructure-landscape/blob/main/data/landscape.json"}