mirror of
https://github.com/kforney/pentest-distro-builder.git
synced 2024-10-06 12:38:52 -06:00
.. | ||
lib | ||
LICENSE.txt | ||
package.json | ||
README.md |
VS Code Debug Protocol
This npm module contains declarations for the json-based Visual Studio Code debug protocol.
History
-
1.28.x:
- Adds an optional attribute
clientName
to theInitialize
request. This makes it possible to surface the human readable name of the client in error messages coming from the adapter. - Adds a
terminateThreads
request and a correspondingsupportsTerminateThreadsRequest
capability. - Made the
__restart
attribute official on thelaunch
orattach
requests. It corresponds to therestart
attribute on theterminated
event. - Adds a
setExpression
request and a correspondingsupportsSetExpression
capability. This request can be used to assign a value to an assignable expression (aka "l-value"). - Adds a new optional
preserveFocusHint
to thestopped
event. A value of true hints to the frontend that this event should not change the focus.
- Adds an optional attribute
-
1.27.x:
- Adds a new
capabilities
event that hints to the frontend that one or more capabilities got updated. - Initial support for logPoints: new attribute
SourceBreakpoint.logMessage
and capabilitysupportsLogPoint
.
- Adds a new
-
1.26.x: no protocol changes
-
1.25.x:
- Adds a new enum value
virtual
for thepresentationHint
attribute of typeVariable
. - To remove env variables from the environment support a 'null' value for
env
attribute inrunInTerminal
request.
- Adds a new enum value
-
1.24.x:
- Adds
removed
to the value set of thereason
attribute of theBreakpointEvent
. - Adds a
locale
attribute to theinitialize
request. The adapter can use this information to translate user visible information.
- Adds
-
1.23.x:
- Adds a
source
,line
, andcolumn
attributes to theOutput
event. With this a frontend can show a link to the source where the output was generated. - Adds support for retrieving loaded scripts and receiving loaded script events (
LoadedSourcesRequest
,LoadedSourceEvent
). - Adds display hints for variables and evaluation results (type
VariablePresentationHint
).
- Adds a
-
1.22.x:
- Adds a new enum value
normal
for thepresentationHint
attribute of typeSource
. - Adds a new event
process
that conveys process ID and other information about the debuggee.
- Adds a new enum value
-
1.21.x:
- Adds optional attribute
includeAll
to typeStackFrameFormat
. With this theStackTraceRequest
can be parameterized to include all stack frames, including those the DA might otherwise hide. - Adds capability
supportsDelayedStackTraceLoading
that indicates that a debug adapter supports the delayed loading of parts of the stack. This requires that both thestartFrame
andlevels
arguments and thetotalFrames
result of theStackTraceRequest
are supported.
- Adds optional attribute
-
1.20.x:
- Extends the type of the
TerminatedEvent.body.restart
attribute fromboolean
toany
. This makes it possible to loop arbitrary data from one debug session to the next. - Adds a new enum value
subtle
for thepresentationHint
attribute of typeStackFrame
.
- Extends the type of the
-
1.19.x:
- Adds a new optional argument
terminateDebuggee
to thedisconnect
request. If a debug adapter has opted into this feature with the 'supportTerminateDebuggee' capability, a client can use this to control whether the debuggee should be terminated when the debugger is disconnected.
- Adds a new optional argument
-
1.18.x:
- Adds optional attribute
source
to theSourceArguments
. - Made StoppedEvent's
reason
attribute robust against translation by introducing a newdescription
attribute. - Add a new optional attribute
presentationHint
to theStackFrame
type. This attribute can be used to control how the frame is rendered in the UI.
- Adds optional attribute
-
1.17.x:
- Adds optional attribute
clientID
to theInitializeRequestArguments
. - Adds support for obtaining exception details:
ExceptionInfoRequest
,ExceptionDetails
. - Adds optional parameter
format
to theSetVariableRequest
.
- Adds optional attribute
-
1.16.x:
- Updated comments for
path
andsourceReference
attributes ofSource
type (the frontend no longer needs to have a notion of 'internal' modules; it just loads the content of a Source either through the sourceReference or the path). - Adds optional
presentationHint
attribute toSource
type. This allows to control how the frontend shows a source reference in th UI. - Removed
SHA1Normalized
andSHA256Normalized
values from typeChecksumAlgorithm
.
- Updated comments for
-
1.15.x:
- Adds a
reverseContinue
request. - Adds a
restart
request and a correspondingsupportsRestartRequest
capability. - Adds a
variablesReference
attribute to theOutputEvent
. - Adds support for exception configuration options.
- Adds formatting options support for values returned from
VariablesRequest
,EvaluateRequest
, andStackTraceRequest
.
- Adds a
-
1.14.x:
- Adds optional
type
attribute to theSetVariableResponse
type. - Support to return a structured object from the
SetVariableRequest
. - Fine tuning of
Module
part of the protocol. - Adds optional attribute
evaluatable
toVariable
type. - Adds optional checksum support to
Source
type. - Adds optional source range to
Scope
type.
- Adds optional
-
1.13.x:
- Fix typo in
Capabilities
type. - Adds an optional
hitCondition
attribute to breakpoints and a correspondingsupportsHitConditionalBreakpoints
capability.
- Fix typo in
-
1.12.x:
- Adds a new optional attribute
frameId
to thecompletionRequest
. - Introduces a
runInTerminalRequest
so that a debug adapter can run a debuggee in a terminal managed by the frontend. - Adds a
type
attribute (and a value set) to theCompletionItem
.
- Adds a new optional attribute
-
1.11.x:
- Adds a new optional attribute
mimeType
to theSourceResponse
. - Adds a new optional attribute
sourceModified
to theSetBreakpointsArguments
that indicates that the underlying source has been modified which results in new breakpoint locations. - Adds a new optional attribute
supportsVariableType
toInitializeRequestArguments
. True indicates that the client shows the variable's type attribute in the UI. - Adds optional 'type' attribute to the
EvaluateResponse
. - Introduces the
RestartFrameRequest
and a correspondingsupportsRestartFrame
capability. - Introduces a
ContinuedEvent
so that a debug adapter can explicit trigger that a thread has continued execution. - Adds support for step in targets (request
StepInTargetsRequest
, typeStepInTarget
, capabilitysupportsStepInTargetsRequest
) - Adds support for goto targets (requests
GotoTargetsRequest
andGotoRequest
, typeGotoTarget
, capabilitysupportsGotoTargetsRequest
) - Adds support for variable paging, that is named and indexed children of a variable can be requested in pages (chunks).
- Adds experimental support for completion proposals.
- Adds a new optional attribute
-
1.10.x:
- Introduces a
stepBack
request and a correspondingsupportsStepBack
capability. - Introduces the type
Module
, aModuleRequest
, and aModuleEvent
- Introduces the
setVariableRequest
- Adds new optional attributes
type
andkind
for aVariable
. - Adds optional attributes
endLine
andendColumn
toStackFrame
andBreakpoint
types.
- Introduces a
-
1.9.x:
- Introduces a
allThreadsContinued
attribute on theContinueResponse
to indicate that all threads are continued and not only the one specified.
- Introduces a
-
1.8.x:
- Introduces
ExceptionBreakpointsFilter
and fixed corresponding capability. - Adds optional
noDebug
attribute toLaunchRequestArguments
. - Adds optional
startFrame
argument toStackTraceArguments
to allow for paging. - Adds optional
totalFrames
argument toStackTraceResponse
to allow for paging. - Improve comment:
InitializedEvent
must not be sent beforeInitializeRequest
has returned its result.
- Introduces
-
1.7.x:
- Adds optional
url
andurlLabel
attributes to the error messages. The frontend will show this as a UI to open additional information in a browser. - Added option
default
attribute to theexceptionBreakpointFilters
capability. - Adds optional attribute
allThreadsStopped
to theStoppedEvent
to indicate that all threads are stopped (and not only the one mentioned in the event).
- Adds optional
-
1.6.x:
- A boolean
supportsConditionalBreakpoints
inCapabilities
indicates whether the debug adapter supports conditional breakpoints. - Adds an optional
exceptionBreakpointFilters
capability that lists the filters available for thesetExceptionBreakpoints
request. - Adds an optional
restart
attribute to theTerminatedEvent
which can be used to request a restart of the debug session.
- A boolean
-
1.5.x:
- A boolean
supportsFunctionBreakpoints
inCapabilities
indicates whether the debug adapter implements the function breakpoints. - Renamed
supportEvaluateForHovers
inCapabilities
tosupportsEvaluateForHovers
.
- A boolean
-
1.4.x:
- Made the
body
of theInitializeResponse
optional (for backward compatibility).
- Made the
-
1.3.x: Version introduces support for feature negotiation.
- The
InitializeResponse
has now attributes for these features:- A boolean
supportsConfigurationDoneRequest
indicates whether the debug adapter implements theConfigurationDoneRequest
. - A boolean
supportEvaluateForHovers
indicates whether the debug adapter supports a side effect freeEvaluateRequest
.
- A boolean
- Adds an optional
data
attribute to theOutputEvent
and atelemetry
category. - Adds a new context type
hover
to thecontext
attribute of theEvaluateArguments
.
- The
-
1.2.x: Version adds a new request:
- Introduces a
ConfigurationDoneRequest
that VS Code sends to indicate that the configuration of the debug session has finished and that debugging can start.
- Introduces a
-
1.1.x: Version adds support for conditional breakpoints and breakpoints in virtual documents:
- Type
Source
supports optionalorigin
attribute to provide information that is shown in the debug UI. - Type
Source
supports an optionaladapterData
attribute that the VS Code debug UI will transparently persists for breakpoints. - Introduces type
SourceBreakpoint
that makes it possible to providecolumn
andcondition
information when specifying a breakpoint.
- Type
-
1.0.1: Initial version of the debug protocol