README.md 3.3 KB
description: "Computer-use provider registration for deployments that enable one desktop driver at a time."
kind: "package-reference"
@deepseek-ai/dsh-computer-use
English | 中文
Summary
A deployment can enable one computer-use provider at a time. Loading another provider fails with the registered provider name. Each provider supplies its own tools and desktop operations. This package adds no model-visible tools and does not coordinate concurrent Sessions.
Table of Contents
- Use this package
- Understand the implementation
- Further Exploration
- Model Experience
- Known Limitations and Deferred Work
- Dev Note
Use this package
Mount the service once beside the chosen provider in a Cordis composition:
- name: '@deepseek-ai/dsh-computer-use'
The service has no configuration. Provider plugins inject computerUse and call ctx.computerUse.register(ComputerUseProviderName(name)); the brand is exported from @deepseek-ai/dsh-computer-use/brand. The returned effect disposer releases that registration.
Providers stop admitting tool calls, close their resources, and await owned work before releasing the registration. ctx.computerUse.providerName reports the registered name until release.
Understand the implementation
Implementation internals — click to expand
One private name owns the slot. Cordis effects remove contributions when their plugin unloads; a repeated disposer cannot remove a later registration. The [source](src/index.ts) contains no driver object, operation interface, or provider selector. No runtime invariant companion is published: the registry has one authoritative field and exposes no independently maintained observation that can diverge. Duplicate rejection and plugin disposal are covered by the owning tests.Further Exploration
- Computer use — provider selection and shared-desktop limits.
- Cua Driver MCP provider — use an installed driver.
- Cua Driver native provider — use the npm runtime.
Model Experience
None, as this registry only records provider names.
KV Cache effect
Registration does not alter model requests. Provider-owned tools and guidance determine their own request-prefix effects.
Known Limitations and Deferred Work
The service limits registrations within its Cordis service instance.
- Shared desktop — concurrent Sessions and separate DSH processes can operate the same desktop; callers coordinate whole computer-use workflows.
- Provider selection — configuration selects the provider; the model cannot switch registered drivers at runtime.