Implement OpenShell CLI extension API in the OpenShell extension

[jeffmaury]

Task content

Based on the new extension API, add an implementation based on the local binary and register the CLI though the new API

[coderabbitai]

⚠️ Possible Duplicate Issue(s)

• Create a backend openshell-cli component similar to kdn-cli #1923

---

📝 Issue Planner

_{Check the box below or use the @coderabbitai plan command to generate an implementation plan and prompts that you can use with your favorite coding assistant.}

• Create Plan

---

🧪 Issue enrichment is currently in open beta.

You can configure auto-planning by selecting labels in the issue_enrichment configuration.

To disable automatic issue enrichment, add the following to your .coderabbit.yaml:

issue_enrichment:
  auto_enrich:
    enabled: false

💬 Have feedback or questions? Drop into our discord!

[fullsend-ai-triage]

🤖 Finished Triage · ✅ Success · Started 9:51 AM UTC · Completed 9:54 AM UTC
Commit: 5908aed · View workflow run →

[fullsend-ai-triage]

Triage Summary

Category: Refactoring / Feature · Severity: Medium

Problem

The OpenshellCli class in packages/main/src/plugin/openshell-cli/openshell-cli.ts is a concrete @injectable() class with no interface abstraction. Related types (e.g., GatewayInfo, SandboxInfo, CreateSandboxOptions) live in packages/api/src/openshell-gateway-info.ts rather than in the extension API, preventing future alternative implementations.

Recommended Approach

1. Define an interface in packages/extension-api capturing the public API surface of OpenshellCli — sandbox CRUD, gateway management, provider operations, etc.
2. Implement the interface on the existing OpenshellCli class.
3. Move related types (GatewayInfo, SandboxInfo, CreateSandboxOptions, PolicyUpdateOptions, GatewayAddOptions, CreateProviderOptions, SetInferenceOptions, OpenshellGatewayStartOptions, and Zod schemas) to the extension API.
4. Update Inversify bindings to use the interface symbol for DI resolution.
5. Update imports across consumers in packages/main and extensions/openshell.

Related Issues

• Refactor openshell cli implementation #2318 — Parent refactoring effort for the openshell CLI
• Define OpenShell extension API #2328 — Defines broader OpenShell extension API types (clients, gateways, registration points)

Proposed Test Case

- Confirm OpenshellCli compiles when implementing the new interface
- Verify all existing OpenshellCli unit tests pass unchanged
- Validate Inversify DI resolves the interface to the concrete class
- Ensure moved types are importable from the extension API
- Run full monorepo TypeScript build to catch stale imports

Previous run

Triage Summary

Category: Refactoring / Feature · Severity: Medium

Problem

The OpenshellCli class in packages/main/src/plugin/openshell-cli/openshell-cli.ts is a concrete @injectable() class with no interface abstraction. Related types (e.g., GatewayInfo, SandboxInfo, CreateSandboxOptions) live in packages/api/src/openshell-gateway-info.ts rather than in the extension API.

Recommended Approach

1. Define an interface in packages/extension-api capturing the public API surface of OpenshellCli — sandbox CRUD, gateway management, provider operations, etc.
2. Implement the interface on the existing OpenshellCli class.
3. Move related types (GatewayInfo, SandboxInfo, CreateSandboxOptions, PolicyUpdateOptions, GatewayAddOptions, CreateProviderOptions, SetInferenceOptions, OpenshellGatewayStartOptions, and Zod schemas) to the extension API.
4. Update Inversify bindings to use the interface symbol for DI resolution.
5. Update imports across consumers in packages/main and extensions/openshell.

Proposed Test Case

- Confirm OpenshellCli compiles when implementing the new interface
- Verify all existing OpenshellCli unit tests pass unchanged
- Validate Inversify DI resolves the interface to the concrete class
- Ensure moved types are importable from the extension API
- Check no stale imports reference the old type locations

This is part of the broader refactoring effort tracked in #2318.

---

Labels: Refactoring task that extracts an interface for the extension API layer, fitting the area/extensibility label and enhancement type.