Skip to content

doc(annotations): Added and improved tsdoc annotations - #655

Merged
dines-rl merged 26 commits into
mainfrom
dines/typedoc-fixes
Nov 20, 2025
Merged

doc(annotations): Added and improved tsdoc annotations#655
dines-rl merged 26 commits into
mainfrom
dines/typedoc-fixes

Conversation

@dines-rl

@dines-rl dines-rl commented Nov 19, 2025

Copy link
Copy Markdown
Contributor

CodeAnt-AI Description

Update SDK docs quickstarts and automate Typedoc publishing

What Changed

  • README now leads with the RunloopSDK quickstart that walks through devbox creation, command execution, async execution, and shutdown so newcomers see a full workflow upfront
  • Inline SDK classes (Blueprint, Devbox, Execution, ExecutionResult, StorageObject, Snapshot) gained quickstart snippets and examples so IDE doc hovers show real-world usage
  • Typedoc now uses README.md, adds dt-links, exposes Markdown output via a docs:md script, and the GH Pages workflow publishes on main pushes/releases so published docs stay current

Impact

✅ Clearer SDK quickstart flow
✅ Markdown SDK docs regenerate on main pushes
✅ Published docs site reflects latest SDK guidance

💡 Usage Guide

Checking Your Pull Request

Every time you make a pull request, our system automatically looks through it. We check for security issues, mistakes in how you're setting up your infrastructure, and common code problems. We do this to make sure your changes are solid and won't cause any trouble later.

Talking to CodeAnt AI

Got a question or need a hand with something in your pull request? You can easily get in touch with CodeAnt AI right here. Just type the following in a comment on your pull request, and replace "Your question here" with whatever you want to ask:

@codeant-ai ask: Your question here

This lets you have a chat with CodeAnt AI about your pull request, making it easier to understand and improve your code.

Example

@codeant-ai ask: Can you suggest a safer alternative to storing this secret?

Preserve Org Learnings with CodeAnt

You can record team preferences so CodeAnt AI applies them in future reviews. Reply directly to the specific CodeAnt AI suggestion (in the same thread) and replace "Your feedback here" with your input:

@codeant-ai: Your feedback here

This helps CodeAnt AI learn and adapt to your team's coding style and standards.

Example

@codeant-ai: Do not flag unused imports.

Retrigger review

Ask CodeAnt AI to review the PR again, by typing:

@codeant-ai: review

Check Your Repository Health

To analyze the health of your code repository, visit our dashboard at https://app.codeant.ai. This tool helps you identify potential issues and areas for improvement in your codebase, ensuring your repository maintains high standards of code health.

@codeant-ai

codeant-ai Bot commented Nov 19, 2025

Copy link
Copy Markdown
Contributor

CodeAnt AI is reviewing your PR.


Thanks for using CodeAnt! 🎉

We're free for open-source projects. if you're enjoying it, help us grow by sharing.

Share on X ·
Reddit ·
LinkedIn

@codeant-ai codeant-ai Bot added the size:L This PR changes 100-499 lines, ignoring generated files label Nov 19, 2025
@codeant-ai

codeant-ai Bot commented Nov 19, 2025

Copy link
Copy Markdown
Contributor

CodeAnt AI finished reviewing your PR.

@github-actions

Copy link
Copy Markdown

✅ Object Smoke Tests & Coverage Report

Test Results

✅ All smoke tests passed

Coverage Results

Metric Coverage Required Status
Functions 100% 100%
Lines 87.24% - ℹ️
Branches 57.3% - ℹ️
Statements 86.7% - ℹ️

Coverage Requirement: 100% function coverage (all public methods must be called in smoke tests)

✅ All tests passed and all object methods are covered!

View detailed coverage report

Coverage reports are available in the workflow artifacts. Lines/branches/statements coverage is tracked but not required to be 100%.

📋 View workflow run

@github-actions

Copy link
Copy Markdown

✅ Object Smoke Tests & Coverage Report

Test Results

✅ All smoke tests passed

Coverage Results

Metric Coverage Required Status
Functions 100% 100%
Lines 87.24% - ℹ️
Branches 57.3% - ℹ️
Statements 86.7% - ℹ️

Coverage Requirement: 100% function coverage (all public methods must be called in smoke tests)

✅ All tests passed and all object methods are covered!

View detailed coverage report

Coverage reports are available in the workflow artifacts. Lines/branches/statements coverage is tracked but not required to be 100%.

📋 View workflow run

@github-actions

Copy link
Copy Markdown

✅ Object Smoke Tests & Coverage Report

Test Results

✅ All smoke tests passed

Coverage Results

Metric Coverage Required Status
Functions 100% 100%
Lines 87.24% - ℹ️
Branches 57.3% - ℹ️
Statements 86.7% - ℹ️

Coverage Requirement: 100% function coverage (all public methods must be called in smoke tests)

✅ All tests passed and all object methods are covered!

View detailed coverage report

Coverage reports are available in the workflow artifacts. Lines/branches/statements coverage is tracked but not required to be 100%.

📋 View workflow run

@github-actions

Copy link
Copy Markdown

✅ Object Smoke Tests & Coverage Report

Test Results

✅ All smoke tests passed

Coverage Results

Metric Coverage Required Status
Functions 100% 100%
Lines 87.24% - ℹ️
Branches 57.3% - ℹ️
Statements 86.7% - ℹ️

Coverage Requirement: 100% function coverage (all public methods must be called in smoke tests)

✅ All tests passed and all object methods are covered!

View detailed coverage report

Coverage reports are available in the workflow artifacts. Lines/branches/statements coverage is tracked but not required to be 100%.

📋 View workflow run

@dines-rl
dines-rl requested a review from jrvb-rl November 19, 2025 23:43
@github-actions

Copy link
Copy Markdown

✅ Object Smoke Tests & Coverage Report

Test Results

✅ All smoke tests passed

Coverage Results

Metric Coverage Required Status
Functions 100% 100%
Lines 87.24% - ℹ️
Branches 57.3% - ℹ️
Statements 86.7% - ℹ️

Coverage Requirement: 100% function coverage (all public methods must be called in smoke tests)

✅ All tests passed and all object methods are covered!

View detailed coverage report

Coverage reports are available in the workflow artifacts. Lines/branches/statements coverage is tracked but not required to be 100%.

📋 View workflow run

@github-actions

Copy link
Copy Markdown

✅ Object Smoke Tests & Coverage Report

Test Results

✅ All smoke tests passed

Coverage Results

Metric Coverage Required Status
Functions 100% 100%
Lines 87.24% - ℹ️
Branches 57.3% - ℹ️
Statements 86.7% - ℹ️

Coverage Requirement: 100% function coverage (all public methods must be called in smoke tests)

✅ All tests passed and all object methods are covered!

View detailed coverage report

Coverage reports are available in the workflow artifacts. Lines/branches/statements coverage is tracked but not required to be 100%.

📋 View workflow run

@github-actions

Copy link
Copy Markdown

✅ Object Smoke Tests & Coverage Report

Test Results

✅ All smoke tests passed

Coverage Results

Metric Coverage Required Status
Functions 100% 100%
Lines 87.24% - ℹ️
Branches 57.3% - ℹ️
Statements 86.7% - ℹ️

Coverage Requirement: 100% function coverage (all public methods must be called in smoke tests)

✅ All tests passed and all object methods are covered!

View detailed coverage report

Coverage reports are available in the workflow artifacts. Lines/branches/statements coverage is tracked but not required to be 100%.

📋 View workflow run

@github-actions

Copy link
Copy Markdown

✅ Object Smoke Tests & Coverage Report

Test Results

✅ All smoke tests passed

Coverage Results

Metric Coverage Required Status
Functions 100% 100%
Lines 87.24% - ℹ️
Branches 57.3% - ℹ️
Statements 86.7% - ℹ️

Coverage Requirement: 100% function coverage (all public methods must be called in smoke tests)

✅ All tests passed and all object methods are covered!

View detailed coverage report

Coverage reports are available in the workflow artifacts. Lines/branches/statements coverage is tracked but not required to be 100%.

📋 View workflow run

@github-actions

Copy link
Copy Markdown

✅ Object Smoke Tests & Coverage Report

Test Results

✅ All smoke tests passed

Coverage Results

Metric Coverage Required Status
Functions 100% 100%
Lines 87.27% - ℹ️
Branches 57.3% - ℹ️
Statements 86.74% - ℹ️

Coverage Requirement: 100% function coverage (all public methods must be called in smoke tests)

✅ All tests passed and all object methods are covered!

View detailed coverage report

Coverage reports are available in the workflow artifacts. Lines/branches/statements coverage is tracked but not required to be 100%.

📋 View workflow run

@jrvb-rl jrvb-rl left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Some initial comments on the README. Still looking at the rest

Comment thread README.md Outdated
Comment thread README.md

// You can also pass a `fetch` `Response`:
await client.devboxes.uploadFile('id', { path: 'path', file: await fetch('https://somesite/file') });
- **[`runloop.devbox`](https://runloopai.github.io/api-client-ts/stable/classes/DevboxOps.html)** - Devbox management (create, list, execute commands, file operations)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Random question: do we have a broken link checker we can run on this? I guess worst case we can run as an after-the-fact thing on the running site

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

I'm hoping we don't change these often, but no I'm not aware of it

Comment thread README.md Outdated
Comment thread README.md Outdated
Comment thread README.md
Comment thread README.md Outdated
```typescript
const runloop = new RunloopSDK({
bearerToken: process.env.RUNLOOP_API_KEY,
baseURL: 'https://api.runloop.ai',

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Do we have public endpoints other than api.runloop.ai? This is useful for us pointing to the dev servers, but is it helpful for other folks?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

this will be for deploy to vpc folks

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

yeah

Comment thread README.md Outdated

@jrvb-rl jrvb-rl left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Very nice! I like the additional examples and overall doc improvements.

Comment thread src/sdk/devbox.ts Outdated
Comment thread src/sdk/devbox.ts
Comment thread src/sdk/devbox.ts Outdated
Comment thread src/sdk/devbox.ts Outdated
Comment thread src/sdk/devbox.ts
Comment thread src/sdk/execution-result.ts Outdated
Comment thread src/sdk/execution-result.ts
@@ -153,6 +174,8 @@ export class ExecutionResult {
* Get the stdout output from the execution. If numLines is specified, it will return the last N lines. If numLines is not specified, it will return the entire stdout output.
* Note after the execution is completed, the stdout is not available anymore.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Is this true even if I do numLines=N for N < the actual total number of lines? Seems like it would be nice to have an option to retrieve a few lines, then get more if the user decides they need them after looking at the first few. (Could be a TODO for later...)

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Yeah if you ask for 100 and it has 1000 it won't go get more? I think there's room here for another method which is like give me what you have, not sure what to name that method ):

Comment thread src/sdk/execution-result.ts Outdated
Comment thread src/sdk/execution-result.ts Outdated
@github-actions

Copy link
Copy Markdown

✅ Object Smoke Tests & Coverage Report

Test Results

✅ All smoke tests passed

Coverage Results

Metric Coverage Required Status
Functions 100% 100%
Lines 87.27% - ℹ️
Branches 57.3% - ℹ️
Statements 86.74% - ℹ️

Coverage Requirement: 100% function coverage (all public methods must be called in smoke tests)

✅ All tests passed and all object methods are covered!

View detailed coverage report

Coverage reports are available in the workflow artifacts. Lines/branches/statements coverage is tracked but not required to be 100%.

📋 View workflow run

@codeant-ai

codeant-ai Bot commented Nov 20, 2025

Copy link
Copy Markdown
Contributor

CodeAnt AI is running Incremental review


Thanks for using CodeAnt! 🎉

We're free for open-source projects. if you're enjoying it, help us grow by sharing.

Share on X ·
Reddit ·
LinkedIn

@codeant-ai codeant-ai Bot added size:L This PR changes 100-499 lines, ignoring generated files and removed size:L This PR changes 100-499 lines, ignoring generated files labels Nov 20, 2025
@codeant-ai

codeant-ai Bot commented Nov 20, 2025

Copy link
Copy Markdown
Contributor

CodeAnt AI Incremental review completed.

@dines-rl
dines-rl merged commit 06d7ef7 into main Nov 20, 2025
8 checks passed
@dines-rl
dines-rl deleted the dines/typedoc-fixes branch November 20, 2025 20:28
@github-actions

Copy link
Copy Markdown

⚠️ Object Smoke Tests & Coverage Report

Test Results

✅ All smoke tests passed

Coverage Results

Metric Coverage Required Status
Functions 90.9% 100%
Lines 82.09% - ℹ️
Branches 51.04% - ℹ️
Statements 81.72% - ℹ️

Coverage Requirement: 100% function coverage (all public methods must be called in smoke tests)

⚠️ Some object methods are not covered in smoke tests. Please add tests that call all public methods.

View detailed coverage report

Coverage reports are available in the workflow artifacts. Lines/branches/statements coverage is tracked but not required to be 100%.

📋 View workflow run

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size:L This PR changes 100-499 lines, ignoring generated files

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants