Regenerate Grpc Stubs
Regenerate Python + TypeScript gRPC stubs after editing proto files.
Install
npx skills add GetBindu/Bindu --skill regenerate-grpc-stubs -g -a claude-code -y- Repository
- GetBindu/Bindu10k
- Category
- Engineering
- Updated
- 2mo ago
- License
- See repository
- Context cost
- Lightabout 742 tokens
- Runs scripts
- No, instructions only
What it does
Regenerate Python + TypeScript gRPC stubs after editing proto files. Use when proto/*.proto changes, imports from bindu.grpc.generated fail, CI reports generated-code drift, or HandleMessages calls fail with proto mismatch.
Regenerate gRPC Stubs
Overview
Bindu's cross-language agents share one proto file: proto/agent_handler.proto. Two generated stub trees must stay in sync with it:
bindu/grpc/generated/, Python stubs for the coresdks/typescript/src/generated/, TypeScript stubs for the SDK
Both languages must be regenerated together and committed in the same PR as the proto change. A proto change without matching stubs leaves main broken for anyone who pulls.
Inputs
<proto_file>: usuallyproto/agent_handler.proto, or whatever file was modified underproto/.
Safety
- Do not edit files under
bindu/grpc/generated/orsdks/typescript/src/generated/. Changes will be overwritten by the next regeneration. - Do not split the proto change and the stub regeneration across PRs. They must land atomically.
- If the proto change is breaking (removed fields, renamed RPCs, changed message types), flag it in the PR description, existing clients will break.
Execution Contract
- Confirm the proto change is intentional and minimal.
- Regenerate both Python and TypeScript stubs via the project's script.
- Verify both stub trees compile.
- Run the gRPC integration tests.
- Commit proto + both generated trees together.
Steps
1. Review the proto diff
git diff proto/agent_handler.proto
For each change, classify:
- Additive (new RPC, new field with a new tag), safe, backward-compatible.
- Breaking (removed field, renumbered tag, renamed RPC), needs a coordination note and a version bump plan.
2. Regenerate all stubs
bash scripts/generate_protos.sh all
The script handles both languages and fixes Python import paths. It is the single source of truth, do not run grpc_tools.protoc or grpc_tools_node_protoc by hand.
