Peta Core Files

Overview

This release includes all changes from v1.1.6 to HEAD (d89f4c1), covering improvements to CustomStdio runtime support, startup diagnostics, lazy-start recovery, OAuth configuration handling, documentation, and test coverage.

Compare: https://github.com/dunialabs/peta-core/compare/v1.1.6...d89f4c1

Highlights

CustomStdio runtime improvements

• Added Docker runner support for ServerCategory.CustomStdio.
• When PETA_CORE_IN_DOCKER=true, non-docker stdio commands are automatically wrapped and executed inside petaio/mcp-runner:latest.
• Explicit docker commands keep their original behavior and are not re-wrapped.
• Added runtime probing for Docker socket, Docker CLI, and Docker daemon availability before launching wrapped commands.
• Added failure classification for wrapped CustomStdio execution, distinguishing runner startup failures from downstream command failures.
• Preserved admin-defined stdioTemplate.cwd during user configuration, so CustomStdio launch plans now retain working-directory context correctly.

Reliability and diagnostics

• Added a new startup diagnostics pipeline for downstream connections.
• Startup diagnostics now capture transport errors, client errors, close events, and stderr output during connection establishment.
• Generic errors such as Request timed out or Connection closed are now replaced with more meaningful diagnostics when better evidence is available.
• Diagnostic formatting now includes structured details such as nested causes, network error metadata, MCP error data, and validation issues.
• Sensitive values such as tokens, passwords, secrets, and authorization fields are redacted from diagnostic output.
• Improved lazy-start lifecycle handling after transport closure.
• Lazy-start managed servers now preserve their existing context and transition back to Sleeping instead of being discarded after unexpected transport close.
• Temporary user-configured servers can now be restored from the active session launch config and woken up again correctly.
• Lazy-start servers remain retryable after startup failure, instead of getting stuck in a non-recoverable state.

OAuth and server configuration fixes

• Fixed OAuth authConf parsing in user server configuration flow.
• YOUR_OAUTH_CODE and YOUR_OAUTH_REDIRECT_URL are now validated safely using optional access instead of assuming all keys exist.
• PKCE verifier is now treated as optional and is only forwarded when present and non-empty.
• Added dedicated tests to verify OAuth template server configuration both with and without PKCE verifier input.
• Removed a temporary debug log introduced during OAuth parsing troubleshooting.

Documentation and API docs

• Refreshed README to reflect recent MCP runtime capabilities and positioning updates.
• Expanded README coverage for anonymous public access, HTTPS and stdio custom tools, durable approval queue behavior, and observability workflows.
• Added detailed Admin API and User API documentation for CustomStdio (category=5) configuration flows.
• Documented Docker deployment behavior for CustomStdio, including the current v1 limitation that host project directories are not auto-mounted into runner containers.
• Updated deployment docs to explain CustomStdio behavior inside Docker environments.
• Refined README wording for Peta Console description.

Test and maintenance updates

• Added test coverage for:
• CustomStdioRunner
• ConnectionStartupDiagnostics
• DownstreamTransportFactory
• ServerManager lazy-start lifecycle
• UserRequestHandler OAuth configure-server flow
• Updated npm test to run a build before executing Jest.
• Extended Jest matching to include tests/**/*.test.js.
• Refreshed package-lock.json metadata and removed yarn.lock.
• Version metadata was bumped to 1.1.7 in package.json.

Merged Pull Requests

• #12 Fix lazy server wakeup after transport close

Full Changelog

• 0ee2c1c docs: refresh README for recent MCP runtime updates
• a0b46c7 Update Peta Console description in README
• a3093f5 docs: add CustomStdio (category=5) API documentation for admin and user endpoints
• de0e869 fix: Pass the stdioTemplate.cwd parameter
• 9b40a80 npm install
• 9b053d9 Add Docker runner support for CustomStdio
• a7bee3a Improve startup connection diagnostics
• d3ec995 Fix lazy server wakeup after transport close
• 6dfea92 Merge pull request [#12] from dunialabs/codex/fix-lazy-server-wakeup
• c81f001 "version": "1.1.7"
• 7a1dcce fix oauth configure server authConf parsing
• d89f4c1 delete log

Notes

• No breaking API change was identified in this range.