[rbs333]

GA consistency pass for the Iris code examples, against the 1.0 SDK APIs (verified with the installed 1.0 betas, which have the same API).

Agent Playbooks

Python (local_examples/iris/playbooks/**/*.py) and TypeScript (**/*.mts):

• Search and lookup results: .matches / .results -> .items
• List pages: .faqs / .skills / .versions / .proposals -> .items; removed the total line (1.0 lists are {items, nextCursor})
• minimum_score / minimumScore -> min_score / minScore
• Proposals: proposal_revision / proposalRevision -> revision, expected_proposal_revision / expectedProposalRevision -> expectedRevision, .status -> .state, entry_type="faq" -> entry_kind="FAQ", action_type="ADD", views INBOX / TRASH
• Upper-case sort_order="DESC"; proposal and evidence source uses kind, not type
• agent-playbooks/quickstart.md: removed "are prereleases"

The page prose already used the 1.0 names. Step markers and step names did not change.

Verification:

• npx tsc --noEmit (NodeNext, ES2022, strict) on every Playbooks .mts against @redis-iris/agent-playbook@1.0.0-beta.1: clean. The unmodified files fail with 24 errors.
• mypy on every Python example against redis-iris main and redis-agent-playbook 1.0.0b1: no missing attributes or keyword arguments. The only output is noise from reused variables and dict-literal inference.
• Runtime check of the enum and filter inputs: pydantic rejects "desc" and "inbox", and rejects a source without kind.
• build/agent_playbook_docs cannot run as-is. It points at the old agent-playbook/ path, pins 0.1.0a3 and 0.1.0-alpha.3, and its fixture serves pre-1.0 shapes (matches, proposalRevision, lower-case states). It needs its own refresh.

Lens

• read_api.py / read_api.sh: outcome=["failed"] -> ["FAILED"]
• read-api.md: redis-agent-lens>=1.0.0; enum values in upper case (UNSET, ENTERED_PROMPT, FETCHED_NOT_USED, INVOKED_EMPTY, NOT_INSTRUMENTED, AVAILABLE, EXPIRED, NOT_CAPTURED, RECORDS, AGGREGATE)

Verification: mypy on all Lens examples against redis-agent-lens 1.0.0b1 and redis_iris.lens. Enum values were checked against the generated models and the Lens OpenAPI. Instrumentation set_outcome("completed") stays lower case, which matches TURN_OUTCOMES.

Context Gateway

No changes. There are no Context Gateway example files under local_examples/; the pages refer to sets that don't exist yet. All its pages belong to #4358. I checked ContextGateway (from_env, call, tools, client, service) and the TypeScript ContextGateway / ContextGatewayService exports against 1.0.

Agent Mesh

No changes. The inline A2A snippets match redis_iris.agent_mesh.a2a: RedisTaskStore(..., takeover=), event_stream(), request_handler(), heartbeat(), create_resumable_rest_routes(...) and resumable_streams_extension(). The FastAPI SSE names are upstream re-exports that exist.

Not in this PR

• Playbooks *.cli.sh (CLI tab) is still pre-1.0. For example, it uses --minimum-score, but the CLI flag is --min-score. It also reads .matches, .proposalRevision and .results[0].
• Lens limits.md says a source "shows not-instrumented". It may refer to the UI label, so I left it.

🤖 Generated with Claude Code

---

Note

Low Risk
Documentation and sample code only; no application or service logic changes.

Overview
Updates Iris Agent Playbooks and Lens docs and embedded examples for the 1.0 SDK contract so copy-pasted code matches GA types and enums.

Playbooks (Python and TypeScript under local_examples/iris/playbooks/): paginated and search responses now iterate items instead of matches, results, or resource-specific list fields; list examples drop total logging. Filters and enums use min_score, DESC, proposal revision / expected_revision, state, INBOX / TRASH, entry_kind, action_type, and evidence source.kind. The quickstart page no longer labels the Python SDK and CLI as prereleases.

Lens (read-api.md plus read_api.py / read_api.sh): install pin moves to redis-agent-lens>=1.0.0; session outcome and documented manifest, availability, and gateway values use uppercase enums (e.g. FAILED, ENTERED_PROMPT, AVAILABLE).

Context Gateway, Agent Mesh, and Playbooks CLI (.cli.sh) examples are unchanged in this PR.

^{Reviewed by Cursor Bugbot for commit 59601f4. Bugbot is set up for automated code reviews on this repo. Configure here.}

[github-actions]

Staging links:
https://redis.io/docs/staging/docs/iris-examples-1.0/develop/ai/context-engine/agent-playbooks/quickstart/
https://redis.io/docs/staging/docs/iris-examples-1.0/develop/ai/context-engine/lens/read-api/

[github-actions]

🧠 Redis Memory

Found 5 related items from repository history (5 new this commit):

• PR — Iris docs: GA consistency pass on the 1.0 release and CLI 🆕

  Part of the GA pass for Redis Iris GA docs #4400. It brings iris-ga-docs in line with the 1.0 release and the current redis-iris CLI.

• Commit — Iris docs: GA consistency pass on the 1.0 release and CLI 🆕

  Iris docs: GA consistency pass on the 1.0 release and CLI

• PR — Iris docs: align with redis-iris SDK and CLI (MOD-20269) 🆕

  Aligns the Iris product docs on iris-ga-docs with the unified redis-iris SDK and CLI (main @ f4e76ef, 0.1.0a6). Part of MOD-20269(ht

• PR — WIP: Redis Agent Playbooks developer docs 🆕

  MOD-19391 — Redis Agent Playbooks developer documentation.

• PR — Iris docs: resync the REST examples and API references to the unified Iris API (MOD-20320) 🆕

  Resyncs the REST, curl, and contract side of the Iris docs to the unified Iris API (redislabsdev/iris RS: Clarify Prometheus config transition from v1 to v2 #2185, Feedback: Update certificates #2186, Feedback: Internode encryption #2187, DOC-5769 C# async TCE support #2188, RS: Added link to update/renew INE certs #2190). re

Memory updated at 59601f4