[Draft] feat(package): add standalone local server package for DeepCode runtime#195
Open
Ri0n72Y wants to merge 15 commits into
Open
[Draft] feat(package): add standalone local server package for DeepCode runtime#195Ri0n72Y wants to merge 15 commits into
Ri0n72Y wants to merge 15 commits into
Conversation
Squash merge headless-server-command-map into main. - Add standalone @vegamo/deepcode-server workspace package - Split server services and HTTP/SSE runtime host - Keep server API docs concise in Chinese and English - Preserve CLI and VSCode companion as separate entrypoints
Ri0n72Y
changed the title
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This is a draft PR for early architecture feedback.
It adds a standalone local HTTP/SSE server package for the existing DeepCode runtime:
@vegamo/deepcode-serverdeepcode-serverdeepcode-server@vegamo/deepcode-coreThe goal is to make DeepCode usable by non-terminal clients, such as a local desktop client, without coupling those clients to the interactive CLI/TUI package.
Motivation
DeepCode already has a reusable runtime layer in
@vegamo/deepcode-core, and both the CLI and VSCode companion build UI-specific entrypoints on top of it.This PR adds a third entrypoint at the same level:
deepcode-server: local HTTP/SSE runtime hostThe server is intended for local clients that need a stable process boundary and a simple frontend contract.
What changed
Added
packages/serverAdded
deepcode-serverbinary entrypointAdded local token authentication by default
Added local-only binding by default, with explicit
--unsafe-bindrequired for non-local bindsAdded HTTP/SSE server services for current exist cli commands
Added concise Chinese and English server API docs:
docs/server-api.mddocs/server-api_en.mdScope
This server exposes existing DeepCode runtime / CLI-TUI capabilities as local HTTP APIs.
It intentionally does not add new product features beyond the current runtime surface.
Validation
Local validation has passed:
Current status
This PR is intentionally kept as a draft for now.
I am using it to validate the server package with a local
deepcode-desktopMVP before marking it ready for final review.Feedback on the package boundary, entrypoint naming, and server scope would be useful before I mark this PR ready.