Skip to content
Muse Code Developer Docs
Search
Ctrl
K
Cancel
Select theme
Dark
Light
Auto
Overview
Integrate with Muse Code
Quickstart
MSP concepts
MSP concepts
Sessions and turns
Commands and idempotency
Approvals
Resume
Exit classification
Durability profiles
The item-revision fold model
MSP wire protocol
MSP wire-level implementer's guide
Envelope and ids
Framing and caps
Backpressure
Errors
Conformance
Cookbook
About the cookbook
Stream a turn's answer into your UI
Approve or deny a tool call
Cancel a running turn
Resume a session and verify what came back
Survive the host dying under you
Handle a fingerprint mismatch
Classify every way the host can exit
List models and switch mid-session
Retry without double-submitting
Answer the agent's question
Queue, steer, and reclaim turns
Examples
Overview
The quickstart journey
The shared harness
What keeps working
Protocol changelog
Extend Muse Code
Overview
Skills
Hooks
MCP servers
Plugins
Overview
Quickstart
Concepts
Packages and capabilities
Trust, review and scopes
Hooks in plugins
MCP servers in plugins
Marketplaces and updates
Compatibility with other plugin formats
Plugins in SDK sessions
Examples
Overview
The weather plugin
A guard hook that blocks risky tool calls
An MCP server in a plugin
Importing a Claude Code or Codex plugin
Reference
Overview
SDK reference
Overview
AbnormalExit
ApprovalDecisionInput
ApprovalFailure
ApprovalFailureHandler
ApprovalHandler
checkServedFingerprint
COMMAND_REJECTED_CODE
COMMAND_REJECTED_KIND
CommandErrorResponse
CommandOptions
Connection
ConnectionOptions
createUuidV7Mint
DeepReadonly
DeltaApplyOutcome
DiscardedSessions
DuplexTransport
ExitClassification
EXPECTED_SCHEMA_FINGERPRINT
fingerprintMismatchMessage
FingerprintWarning
FoldedItem
FoldItems
FoldOutcome
FoldSessionState
GapFillFailureHandler
GapFillFailureReason
HostDeathDischarge
HostDeathNotification
isLaunchFailure
ItemApplyOutcome
ItemStore
MspError
MspHandshake
MuseClient
MuseClientOptions
MuseClientSpawnOptions
MuseForeignSessionError
MuseGapFillError
MuseHostDiedError
MuseServeChild
MuseServeChildOptions
MuseSessionDiscardedError
NotificationHandler
PendingApproval
PendingCommandAck
PendingCommandEntry
PendingCommandSet
PendingCommandSetOptions
PendingCommandView
PendingDisposition
PendingJoinPlan
PendingRetirement
ProcessExit
ProtocolError
ProtocolErrorHandler
readSessionDurability
ReplayAnswer
ResumeSessionOptions
RevisionedItem
SendUserTurnOptions
ServerRequestHandler
Session
SessionApplyOutcome
SessionApplyRefusal
SessionDurabilityProfile
SessionFold
SessionFoldView
SessionGapBuffered
SessionGapOverlap
SessionOpening
SessionOptions
SessionStateMethod
SessionStateParams
SessionStateStore
SnapshotJoinFacts
SpawnedMspConnection
spawnMspConnection
SpawnMspConnectionOptions
StaleDroppableMethod
StartSessionOptions
StateApplyOutcome
StateValue
TerminalUnknownItemAnnotation
TransportEof
Turn
TurnEntry
TurnOutcome
TurnState
ViewEvent
Python SDK reference
Overview
ApprovalDecisionInput
ApprovalFailure
ApprovalFailureHandler
ApprovalHandler
DiscardedSessions
EXPECTED_SCHEMA_FINGERPRINT
GapFillFailureHandler
GapFillFailureReason
HostDeathDischarge
HostDeathNotification
is_abnormal_host_death
is_launch_failure
ItemStore
load_transcript
MuseClient
MuseClientOptions
MuseClientSpawnOptions
MuseForeignSessionError
MuseGapFillError
MuseHostDiedError
MuseSessionDiscardedError
PendingCommandSet
PendingCommandView
read_session_durability
replay_into_fold
ResumeSessionOptions
SendUserTurnOptions
Session
SessionApplyOutcome
SessionDurabilityProfile
SessionFold
SessionFoldView
SessionGapBuffered
SessionGapOverlap
SessionStateStore
StartSessionOptions
SyncMuseClient
SyncSession
SyncTurn
Transcript
transcript_dirs
TransportEof
Turn
TurnOutcome
Plugin reference
Manifest
Hook events and payloads
The muse plugins command
Validation diagnostics
Wire protocol reference
Methods
Overview
account/loginCancel
account/loginStart
account/logout
account/read
approval/decide
approval/listPending
goal/clear
goal/edit
goal/pause
goal/resume
goal/set
initialize
item/readOutput
model/list
session/compact
session/fork
session/list
session/read
session/rename
session/resume
session/setApprovalMode
session/setModel
session/setReasoningEffort
session/start
session/userShell
skill/list
subagent/close
subagent/followupTask
subagent/interrupt
subagent/readResult
subagent/reopen
subagent/resume
subagent/sendMessage
subagent/stop
task/background
task/stop
task/stopAll
turn/cancel
turn/interrupt
turn/start
turn/steer
turn/unqueue
usage/read
userInput/answer
userInput/cancel
userInput/clarify
view/page
view/subscribe
view/unsubscribe
workflow/cancel
workflow/childControl
Notifications
Overview
account/changed
account/loginCompleted
approval/requested
approval/resolved
approval/updated
initialized
item/completed
item/delta
item/started
item/updated
session/approvalModeChanged
session/branchChanged
session/contextUsage
session/goalChanged
session/listChanged
session/modelChanged
session/modelRouteUnserved
session/nameChanged
session/reasoningEffortChanged
session/statusChanged
session/todoListChanged
session/tokenUsage
session/viewHealthChanged
skill/changed
turn/completed
turn/retracted
turn/retryScheduled
turn/started
turn/unqueued
usage/changed
userInput/requested
userInput/settled
view/gap
Errors
Overview
approvalAlreadyResolved (-32051)
approvalChoiceInvalid (-32052)
approvalNotFound (-32050)
approvalRequirementStale (-32053)
approvalReviewerUnavailable (-32054)
backpressured (-32031)
boundaryPruned (-32042)
cancelled (-32014)
capabilityRequired (-32010)
commandRejected (-32030)
forkBoundaryInvalid (-32023)
inputTooLarge (-32002)
internal (-32603)
interrupted (-32013)
invalidParams (-32602)
invalidRequest (-32600)
methodNotFound (-32601)
notFound (-32011)
outputUnavailable (-32041)
overloaded (-32001)
parseError (-32700)
sessionAmbiguous (-32022)
sessionInUse (-32021)
sessionNotFound (-32020)
sessionNotLoaded (-32024)
sessionStreamMismatch (-32025)
skillNotFound (-32032)
userInputAlreadySettled (-32056)
userInputAnswerInvalid (-32057)
userInputNotFound (-32055)
viewTruncated (-32040)
Types
Overview
AccountLoginCancelResult
AccountLoginCompletedParams
AccountLoginOutcome
AccountLoginStartParams
AccountLoginStartResult
AccountLoginType
AccountState
AccountStateKind
ApprovalAmendment
ApprovalAmendmentDurability
ApprovalChange
ApprovalChoice
ApprovalChoiceScope
ApprovalDecideParams
ApprovalDecideResult
ApprovalDecision
ApprovalListPendingParams
ApprovalListPendingResult
ApprovalMode
ApprovalModeApplyOutcome
ApprovalModeSource
ApprovalOrigin
ApprovalPersistenceStatus
ApprovalPolicyResult
ApprovalRequestParams
ApprovalRequirementRef
ApprovalResolutionSummary
ApprovalResolvedBy
ApprovalResolvedParams
ApprovalStage
ApprovalStageEvidence
ApprovalStageResolution
ApprovalSubagentOrigin
ApprovalSubject
ApprovalSuggestedPrefix
ApprovalUpdatedParams
AttentionFlag
BackgroundInitiator
BranchState
CapabilityName
ClientCapabilities
ClientInfo
CommandAcceptedResult
CommandAckStatus
CommandStatus
CompactionOutcome
CompactionTrigger
CompactStatus
ContextPressureLevel
ContextUsage
CumulativeTokenUsage
EffectiveApprovalModeState
EffectiveModel
ErrorData
ErrorKind
ErrorObject
ErrorResponse
ForkCutPoint
ForkProvenance
Goal
GoalClearParams
GoalCommandResult
GoalEditParams
GoalPauseParams
GoalResumeParams
GoalSetParams
HistoryMode
HistoryNoneReason
HistoryPreference
IfBusy
InitializeParams
InitializeResult
Item
ItemCompletedParams
ItemDeltaParams
ItemKind
ItemReadOutputEncoding
ItemReadOutputParams
ItemReadOutputResult
ItemStartedParams
ItemStatus
ItemUpdatedParams
JsonRpcVersion
MessageAttachment
ModelCatalogEntry
ModelCatalogSource
ModelChangeSource
ModelCost
ModelListParams
ModelListResult
ModelSelection
ModelVisibleContent
Notification
OutputRef
OutputRefAvailability
PatchSummary
PendingApprovalPointer
PendingRequestKind
PendingRequestPointer
PendingUserInputPointer
PlatformFamily
PlatformOs
ReasoningEffort
ReasoningEffortChangeSource
ReasoningEffortState
RecordPosition
Request
RequestId
RequestReceipt
SchemaInfo
ServerInfo
Session
SessionApprovalModeChangedParams
SessionBranchChangedParams
SessionCompactParams
SessionCompactResult
SessionConfig
SessionContextUsageParams
SessionDurability
SessionForkParams
SessionForkResult
SessionGoalChangedParams
SessionHistory
SessionListChangedParams
SessionListParams
SessionListResult
SessionMcpServerConfig
SessionMcpServerMode
SessionMcpStdioFraming
SessionModelChangedParams
SessionModelRouteUnservedParams
SessionNameChangedParams
SessionReadParams
SessionReadResult
SessionReasoningEffortChangedParams
SessionRenameParams
SessionRenameResult
SessionResumeParams
SessionResumeResult
SessionSetApprovalModeParams
SessionSetApprovalModeResult
SessionSetModelParams
SessionSetModelResult
SessionSetReasoningEffortParams
SessionSetReasoningEffortResult
SessionStartParams
SessionStartResult
SessionStatus
SessionStatusChangedParams
SessionTodoListChangedParams
SessionTokenUsageParams
SessionUserShellParams
SessionUserShellResult
SessionViewHealth
SessionViewHealthChangedParams
SkillCatalogEntry
SkillChangedParams
SkillListParams
SkillListResult
SkillSource
SnapshotAnchor
SnapshotState
SourceRange
StreamRef
SubagentControlStatus
SubagentInputParams
SubagentOwnerReasonParams
SubagentResult
SubagentTargetParams
SubscriptionUsage
SubscriptionUsageWeekly
SubscriptionUsageWindow
SuccessResponse
TaskBackgroundParams
TaskCommandResult
TaskStopAllParams
TaskStopAllResult
TaskStopParams
TodoItem
TodoListState
TodoStatus
TokenUsage
TraceContext
TurnCancelParams
TurnCancelResult
TurnCompletedParams
TurnError
TurnErrorKind
TurnInputPart
TurnInputPartType
TurnInterruptParams
TurnInterruptResult
TurnRef
TurnRetractedParams
TurnRetryScheduledParams
TurnStartDisposition
TurnStartedParams
TurnStartParams
TurnStartResult
TurnSteerParams
TurnSteerResult
TurnTerminal
TurnUnqueuedParams
TurnUnqueueParams
TurnUnqueueResult
UnframedViewNotification
UnframedViewNotificationParams
UsageReadResult
UserInputAnswer
UserInputAnswerParams
UserInputAnswerResult
UserInputCancelParams
UserInputCancelResult
UserInputClarification
UserInputClarifyParams
UserInputClarifyResult
UserInputOption
UserInputOptionPreview
UserInputOutcome
UserInputQuestion
UserInputRequestParams
UserInputSelection
UserInputSelectionMode
UserInputSettledParams
UserInputSettlementSummary
Vcs
ViewGapParams
ViewPageAnchor
ViewPageDirection
ViewPageParams
ViewPageResolvedAnchor
ViewPageResult
ViewSnapshot
ViewSubscribeParams
ViewSubscribeResult
ViewUnsubscribeParams
ViewUnsubscribeResult
WorkflowCancelParams
WorkflowChild
WorkflowChildAction
WorkflowChildControlParams
WorkflowControlResult
Capabilities
Overview
rawLog
sessionListStream
sessionMcp
userShell
Reserved identifiers
Overview
-32012
-32060..-32069
deprecationNotice
Select theme
Dark
Light
Auto
Developer Preview
Capabilities
rawLog
sessionListStream
sessionMcp
userShell
Source
schema/msp/experimental/msp.schema.json