Skip to content

Publish conversation examples to the docs Cookbook tab - #13

Open
jpshackelford wants to merge 3 commits into
mainfrom
publish/conversations
Open

jpshackelford wants to merge 3 commits into
mainfrom
publish/conversations

Conversation

@jpshackelford

Copy link
Copy Markdown
Member

Why

This PR publishes 6 examples in the Conversation monitoring & reacting category:

  • conversation-metrics: Added example.yaml, fixed title to Title Case
  • conversation-tags: Fixed example.yaml title to Title Case (already published)
  • finish-callback: Added example.yaml, simplified title to Title Case
  • react-to-state-websocket: Added example.yaml, simplified title to Title Case
  • server-info-idle: Added example.yaml, simplified title to Title Case
  • watch-terminal-state: Added example.yaml, simplified title to Title Case

Validation

  • npm run check: ✅ All 7 examples render cleanly
  • Changes limited to example directories

This PR was created by an AI agent (OpenHands) on behalf of the user.

Co-authored-by: openhands <openhands@all-hands.dev>
@github-actions

github-actions Bot commented Oct 5, 2026 •

Copy link
Copy Markdown

Coverage

Coverage Report
FileStmtsMissCoverMissing
__init__.py50100% 
cli.py65395%59–60, 100
client.py1051784%56, 109, 117, 150, 160–162, 173, 203, 206–208, 210, 217–219, 221
metrics.py80298%102, 182
v0.py48394%88, 104, 141
v1.py83989%86, 90, 94, 131, 135, 155, 178, 206, 214
TOTAL3863491% 

@github-actions

github-actions Bot commented Oct 5, 2026 •

Copy link
Copy Markdown

Docs preview

✅ Docs preview is ready: https://allhandsai-cookbook-preview-pr-13.mintlify.site

Page Change
/cookbook/command-blacklist updated
/cookbook/conversation-metrics added
/cookbook/conversation-tags updated
/cookbook/finish-callback added
/cookbook updated
/cookbook/react-to-state-websocket added
/cookbook/server-info-idle added
/cookbook/watch-terminal-state added

Docs PR: OpenHands/docs#896 (draft preview; never merged, closes with this PR).
Rendered from b73c7c4. After merge, a separate sync PR updates the docs.

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good work publishing these conversation monitoring examples! All 5 new example.yaml files are correctly structured with valid categories, unique icons, and Title Case titles. The npm run check passes cleanly.

One issue found: the conversation-tags README title needs to be updated to match the example.yaml title.

[RISK ASSESSMENT]

Risk level: LOW

  • Changes are metadata-only (example.yaml files and README titles)
  • All examples render cleanly
  • No code or functional changes

Was this automated review useful? React with 👍 or 👎 to this review to help us measure review quality.
Workflow run: https://github.com/OpenHands/enterprise-cookbook/actions/runs/37359595945

@@ -1,5 +1,5 @@
---
title: Conversation tags
title: Conversation Tags

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟠 Important: The README title must match the example.yaml title. The README currently has:

# Attach metadata to a conversation with tags

But example.yaml now has title: Conversation Tags. According to STYLEGUIDE.md (line 66):

The example's name in Title Case. On the docs site it is replaced by the title in example.yaml, so make them match.

This is also part of the required upleveling checklist (line 273).

Suggested change
title: Conversation Tags
title: Conversation Tags

Please update conversation-tags/README.md line 1 to:

# Conversation Tags

The plugins payload still loaded from the archived jpshackelford/oh-examples.
Only the source changes; the message and other parameters are unchanged.

Co-authored-by: openhands <openhands@all-hands.dev>
openhands-release-bot Bot added a commit to OpenHands/docs that referenced this pull request Oct 6, 2026
… merge)

Preview of the Enterprise Cookbook pages produced by OpenHands/enterprise-cookbook#13 (Publish conversation examples to the docs Cookbook tab), rendered from OpenHands/enterprise-cookbook@41aebcc.

**Do not merge.** This draft exists only to get a Mintlify preview. It is updated on every push to the source PR and closed when that PR closes. Merged changes reach the docs through a separate `cookbook-sync` PR.

_Opened automatically by the docs-preview workflow in OpenHands/enterprise-cookbook._
Co-authored-by: openhands <openhands@all-hands.dev>
openhands-release-bot Bot added a commit to OpenHands/docs that referenced this pull request Oct 6, 2026
… merge)

Preview of the Enterprise Cookbook pages produced by OpenHands/enterprise-cookbook#13 (Publish conversation examples to the docs Cookbook tab), rendered from OpenHands/enterprise-cookbook@b73c7c4.

**Do not merge.** This draft exists only to get a Mintlify preview. It is updated on every push to the source PR and closed when that PR closes. Merged changes reach the docs through a separate `cookbook-sync` PR.

_Opened automatically by the docs-preview workflow in OpenHands/enterprise-cookbook._
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants