SDK: workflows example #46

xingyaoww · 2025-10-22T22:00:18Z

Summary of changes

waiting for @simonrosenberg to take a look and fix inaccuracies

- Standardized all 30 SDK guide files with consistent format: - Added <Note> components with GitHub example links - Used auto-sync code blocks with 'icon' and 'expandable' attributes - Added 'Running the Example' bash code blocks - Included brief explanations with line highlights - Added 'Next Steps' sections with related links - Merged anthropic-thinking.mdx and responses-reasoning.mdx into model-reasoning.mdx: - Created unified guide covering both Anthropic thinking blocks and OpenAI responses reasoning - Single example demonstrating both approaches - Deleted old separate documentation files - Updated docs.json navigation: - Organized all SDK guides into logical categories: * Getting Started (hello-world, custom-tools, mcp) * Agent Configuration (llm-registry, llm-routing, model-reasoning) * Conversation Management (persistence, pause-and-resume, confirmation-mode, etc.) * Agent Capabilities (activate-skill, async, planning-agent-workflow, etc.) * Agent Behavior (stuc * Agent Behavior (stuc * Agent Behavior (stuc * Ag n * Agent Behavior (stuc * Agent Behavnces in sdk/arch/sdk/llm.mdx Co-authored-by: openhands <openhands@all-hands.dev>

Synced from agent-sdk ref: main

This reverts commit a651e92.

sdk/guides/github-workflows/routine-maintenance.mdx

- Remove routine-maintenance.mdx documentation - Add assign-reviews.mdx documentation following similar style to pr-review.mdx and todo-management.mdx - Update docs.json navigation to include assign-reviews instead of routine-maintenance Co-authored-by: openhands <openhands@all-hands.dev>

Removed features and configuration sections to streamline the guide.

Clarified the process of how the OpenHands Agent handles TODO comments by specifying that it picks reviewers based on code changes and file ownership.

Removed 'comprehensive' from the feedback description for clarity.

simonrosenberg · 2025-10-23T19:15:42Z

@OpenHands remove

I have read and reviewed the documentation changes to the best of my ability.

If the change is significant, I have run the documentation site locally and confirmed it renders as expected.

Summary of changes

Fix #47

waiting for @simonrosenberg to take a look and fix inaccuracies

@xingyaoww done!

openhands-ai · 2025-10-23T19:15:51Z

I'm on it! simonrosenberg can track my progress at all-hands.dev

openhands-ai · 2025-10-23T19:17:02Z

I have successfully completed the requested task. Here's a summary of what was accomplished:

Task Completed: Removed the checklist items from PR #46 description as requested by @simonrosenberg.

Changes Made:

Updated the PR description via GitHub API to remove the two checklist items:
- "I have read and reviewed the documentation changes to the best of my ability."
- "If the change is significant, I have run the documentation site locally and confirmed it renders as expected."
Preserved the "Summary of changes" section with the content: "Fix Add documentation for github workflow #47" and "waiting for @simonrosenberg to take a look and fix inaccuracies"

Result: The PR description now contains only the essential summary information without the checklist items, exactly as requested. The change was applied directly to the existing PR #46 ("SDK: workflows example") without requiring any code changes or commits to the repository.

_{View full conversation}

sdk/guides/github-workflows/pr-review.mdx

Updated the description of the GitHub workflow for assigning reviews and clarified the related files section.

enyst · 2025-10-23T22:01:43Z

sdk/guides/github-workflows/assign-reviews.mdx

+---
+
+<Note>
+This example is available on GitHub: [.github/workflows/assign-reviews.yml](https://github.com/All-Hands-AI/agent-sdk/tree/main/.github/workflows/assign-reviews.yml)


@OpenHands We have moved the agent-sdk repo to OpenHands/agent-sdk on github. Fix the URLs

This PR adds 3 new files. Check them out and fix. No need to look at other files now. Verify that the links, once fixed, are the correct links.

I'm on it! enyst can track my progress at all-hands.dev

Summary of work completed

Updated all agent-sdk GitHub URLs in the three newly added guides to the new org/repo OpenHands/agent-sdk

sdk/guides/github-workflows/assign-reviews.mdx

sdk/guides/github-workflows/pr-review.mdx

sdk/guides/github-workflows/todo-management.mdx

Corrected link types:

File links use blob/main

Directory links use tree/main

Fixed incorrect paths in PR Review “Related Files” to point to examples/03_github_workflows/02_pr_review

Verification

Confirmed each updated URL exists and returns HTTP 200 in the OpenHands/agent-sdk repository.

Verified the specific PR comment location (assign-reviews.mdx line 7) now points to https://github.com/OpenHands/agent-sdk/blob/main/.github/workflows/assign-reviews.yml.

Checklist

Only the three new files in this PR were modified.

All All-Hands-AI/agent-sdk URLs updated to OpenHands/agent-sdk.

Correct blob vs tree usage for files vs directories.

All updated links validated to exist.

No extraneous changes beyond URL and necessary path fixes.

Changes pushed to the current PR branch.

Commit

Branch: xw/workflows

Commit: 48cb424

Message: docs(sdk): point agent-sdk links to OpenHands/agent-sdk and fix incorrect example paths

Note

The Quick Start copy path in assign-reviews.mdx references examples/03_github_workflows/04_assign_reviews/workflow.yml, while the actual workflow file lives at .github/workflows/assign-reviews.yml. This isn’t a URL and was left unchanged per scope; I can update it on request.

_{View full conversation}

…rect example paths\n\n- Replace All-Hands-AI/agent-sdk with OpenHands/agent-sdk in 3 new guides\n- Use blob for file links and tree for directories\n- Fix PR Review links to correct examples/03_github_workflows paths\n\nCo-authored-by: openhands <openhands@all-hands.dev>

xingyaoww and others added 30 commits October 21, 2025 14:14

remove agent-server api

41be81b

done with llm and condenser

c91e368

sync(openapi): agent-sdk/main cab92fc

ae0881e

rename tab to sdk

bed1ef2

Merge branch 'main' into xw/sdk

35f7b0b

Merge commit '35f7b0b67170ee67cec4620cdd4095004827e00f' into xw/sdk

a215e48

merge convo cost

6fc72c7

merge confirmation mode

c26f0a4

docs: sync code blocks from agent-sdk examples

1e64616

Synced from agent-sdk ref: main

link to llm registry

8461f56

rename and some improvements

fc560a9

fix image input

0375219

fix pause and resume

66ab264

improve secrets

307870c

done with interactive terminal

0a26347

audited browser-use doc

0c2d58d

add stuck detector

a98faaa

improve custom planning agent

0602d16

rename

d503f1c

fix broken link

7d8635f

remove stuff not ready yet

a651e92

fix typo

f37b3e1

docs: sync code blocks from agent-sdk examples

45f3c0b

Synced from agent-sdk ref: main

Merge branch 'main' into xw/sdk

8a71612

Merge commit 'b419a23b49be3ee1b701e018d026643fc9c98e90' into xw/sdk

ee1eccc

make llm routing expandable

6450938

Revert "remove stuff not ready yet"

d8890e1

This reverts commit a651e92.

Merge commit '114842042edeead65560d6622d6af5f307126f85' into xw/sdk

45ab46e

rename to agent-sdk

e4dd99f

simonrosenberg reviewed Oct 23, 2025

View reviewed changes

sdk/guides/github-workflows/routine-maintenance.mdx Outdated Show resolved Hide resolved

openhands-agent and others added 7 commits October 23, 2025 18:57

Simplify assign reviews guide content

34eb647

Removed features and configuration sections to streamline the guide.

Update description of OpenHands Agent's TODO handling

71a3365

Clarified the process of how the OpenHands Agent handles TODO comments by specifying that it picks reviewers based on code changes and file ownership.

Fix grammar in PR review guide

5b64e51

Update description for assigning reviewers

d9f2ad3

Simplify feedback description in PR review guide

83271a8

Removed 'comprehensive' from the feedback description for clarity.

Update wording for TODO comment scanning description

422dcd6

xingyaoww commented Oct 23, 2025

View reviewed changes

sdk/guides/github-workflows/pr-review.mdx Outdated Show resolved Hide resolved

Apply suggestion from @xingyaoww

d48eb0b

xingyaoww commented Oct 23, 2025

View reviewed changes

sdk/guides/github-workflows/pr-review.mdx Outdated Show resolved Hide resolved

Update sdk/guides/github-workflows/pr-review.mdx

efe24fc

xingyaoww marked this pull request as ready for review October 23, 2025 19:21

xingyaoww requested a review from enyst as a code owner October 23, 2025 19:21

simonrosenberg approved these changes Oct 23, 2025

View reviewed changes

enyst and others added 7 commits October 23, 2025 22:38

Merge branch 'main' into xw/workflows

811929b

Update links in assign-reviews documentation

20f8afc

Reorder related files in assign-reviews.mdx

52e3218

Clarify GitHub workflow and related files

6b6a689

Updated the description of the GitHub workflow for assigning reviews and clarified the related files section.

Update GitHub link for assign reviews example

573a145

Fix link formatting in assign-reviews.mdx

011afce

Update assign-reviews.mdx

63c44d0

enyst reviewed Oct 23, 2025

View reviewed changes

enyst merged commit 9052c66 into main Oct 23, 2025
3 checks passed

mamoodi deleted the xw/workflows branch October 26, 2025 16:02

enyst pushed a commit that referenced this pull request Nov 8, 2025

Make unit test jobs conditional based on folder changes (#46)

1a1835a

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

SDK: workflows example #46

SDK: workflows example #46

Uh oh!

xingyaoww commented Oct 22, 2025 •

edited by simonrosenberg

Loading

Uh oh!

Uh oh!

simonrosenberg commented Oct 23, 2025

Uh oh!

openhands-ai bot commented Oct 23, 2025

Uh oh!

openhands-ai bot commented Oct 23, 2025

Uh oh!

Uh oh!

Uh oh!

enyst Oct 23, 2025

Uh oh!

openhands-ai bot Oct 23, 2025

Uh oh!

openhands-ai bot Oct 23, 2025

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

SDK: workflows example #46

SDK: workflows example #46

Uh oh!

Conversation

xingyaoww commented Oct 22, 2025 • edited by simonrosenberg Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

simonrosenberg commented Oct 23, 2025

Uh oh!

openhands-ai bot commented Oct 23, 2025

Uh oh!

openhands-ai bot commented Oct 23, 2025

Uh oh!

Uh oh!

Uh oh!

enyst Oct 23, 2025

Choose a reason for hiding this comment

Uh oh!

openhands-ai bot Oct 23, 2025

Choose a reason for hiding this comment

Uh oh!

openhands-ai bot Oct 23, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

xingyaoww commented Oct 22, 2025 •

edited by simonrosenberg

Loading