deepagents-code
Description
🧠🤖 Deep Agents Code
Quick Install
curl -LsSf https://langch.in/dcode | bash# With model provider extras
# OpenAI, Anthropic, and Gemini are included by default
DEEPAGENTS_CODE_EXTRAS="nvidia,ollama" curl -LsSf https://langch.in/dcode | bashRun:
dcode🤔 What is this?
The fastest way to start using Deep Agents. deepagents-code is a pre-built coding agent in your terminal — similar to Claude Code or Cursor — powered by any LLM that supports tool calling. One install command and you're up and running, no code required.
What deepagents-code adds on top of the SDK:
- Interactive TUI — rich terminal interface with streaming responses
- Conversation resume — pick up where you left off across sessions
- Web search — ground responses in live information
- Remote sandboxes — run code in isolated environments (LangSmith, AgentCore, Daytona, Modal, Runloop, & more)
- Persistent memory — agent remembers context across conversations
- Custom skills — extend the agent with your own slash commands
- Headless mode — run non-interactively for scripting and CI
- Human-in-the-loop — approve or reject tool calls before execution
🔒 Security model
By default, dcode trusts the directory you run it in. Human-in-the-loop approval gates model-requested tool calls, but project artifacts are read before any approval prompt.
Do not run dcode in a directory you do not trust without a sandbox backend. For untrusted repositories, use a remote sandbox so execution is isolated from your machine. Running dcode in a directory lets that directory's files shape execution. See THREAT_MODEL.md for details.
📖 Resources
- Documentation
- Changelog
- Source code
- Deep Agents SDK — underlying agent harness
- LangChain Academy — Comprehensive, free courses on LangChain libraries and products, made by the LangChain team.
- Code of Conduct — community guidelines and standards
📕 Releases & Versioning
See our Releases and Versioning policies.
💁 Contributing
As an open-source project in a rapidly developing field, we are extremely open to contributions, whether it be in the form of a new feature, improved infrastructure, or better documentation.
For detailed information on how to contribute, see the Contributing Guide.
🤝 Acknowledgements
This project was primarily inspired by Claude Code, and initially was largely an attempt to see what made Claude Code general purpose, and make it even more so.
Classes
Class
BypassTier
Classification that controls whether a command can skip the message queue.
Class
SlashCommand
A single slash-command definition.
Class
CommandEntry
A single autocomplete entry for the slash-command controller.
Class
ThemeColors
Complete set of semantic colors for one theme variant.
Class
ThemeEntry
Metadata for a registered theme.
Class
AutoDecisionCategory
Classifier denial categories exposed to the agent and TUI.
Class
AutoDecision
One structured classifier decision for a proposed tool call.
Class
AutoDecisionBatch
Validated classifier response for one unresolved action batch.
Class
AutoModeCounters
Server-owned denial and availability counters for one thread.
Class
PlannedDecision
Checkpoint-safe disposition for one gated call.
Class
AutoDecisionPlan
Private checkpoint record joining model output to after-model routing.
Class
AutoTempArtifact
Server-owned provenance for one exclusively allocated scratch file.
Class
AutoTempArtifactMutation
Reducer update that creates or removes one exact artifact record.
Class
AutoModeState
Agent state carrying private Auto decisions and scratch provenance.
Class
PromptMetadata
Trusted metadata attached by the Textual client to a user message.
Class
AutoModeHITLMiddleware
Apply deterministic policy, classifier review, and HITL fallback.
Class
HeadlessMCPGuardMiddleware
Reject dynamically gated MCP calls when no approval UI exists.
Class
ImageData
Represents a pasted image with its base64 encoding.
Class
VideoData
Represents a pasted video with its base64 encoding.
Class
GoalProposal
Structured proposal returned by the criteria agent.
Class
GoalCreateRequest
A new proposal or a rejection-based regeneration.
Class
GoalAmendRequest
An amendment to an accepted goal; both extra fields are required.
Class
GoalCriteriaState
Main-agent state carrying a criteria request until it is cleared.
Class
GoalCriteriaAgentState
Private per-invocation state for the nested criteria agent.
Class
GoalCriteriaMiddleware
Run goal-criteria requests entirely inside the main server graph.
Class
OAuthInteraction
User-facing OAuth interaction surface shared by CLI and TUI.
Class
CliOAuthInteraction
Default OAuthInteraction that drives the flow via stdin/stdout.
Class
QueuedMessage
Represents a queued user message awaiting processing.
Class
ExternalInput
Textual message carrying an external prompt or command.
Class
DeferredAction
An action deferred until the current busy state resolves.
Class
TextualSessionState
Session state for the Textual app.
Class
Scrolled
Posted whenever the chat's vertical scroll offset changes.
Class
Resized
Posted whenever the bottom chrome's geometry changes.
Class
DeepAgentsApp
Main Textual application for deepagents-code.
Class
ServerReady
Posted by the background server-startup worker on success.
Class
ServerStartFailed
Posted by the background server-startup worker on failure.
Class
AppResult
Result from running the Textual application.
Class
AskUserMiddleware
Middleware that provides an ask_user tool for interactive questioning.
Class
ShellAllowListMiddleware
Validate shell commands against an allow-list without HITL interrupts.
Class
AsyncApprovalHITLMiddleware
Stock HITL routing with an async live-mode read after model completion.
Class
ExternalEditorError
Raised when an external editor cannot be opened or read.
Class
RepositoryBounds
Path-safety and size limits for read-only repository inspection tools.
Class
ShadowedDcode
A different dcode entry point is winning on PATH than the one we upgraded.
Class
DependencyChange
A single package version change parsed from uv's environment-diff output.
Class
ToolRequirementIntrospectionError
Raised when uv tool requested requirements cannot be preserved.
Class
GoalRubricChannels
Goal/rubric state channels shared by every schema that touches them.
Class
ResumeState
Extends agent state with per-checkpoint facts restored on resume.
Class
ResumeStateMiddleware
Persists per-checkpoint resume facts after each model call.
Class
RubricSnapshot
Read-only rubric view returned by the get_rubric tool to the model.
Class
GoalSnapshot
Read-only goal view returned by the get_goal tool to the model.
Class
GoalToolState
State fields used by goal tools.
Class
GoalToolsMiddleware
Expose constrained goal tools and maintain the goal-state notice.
Class
ParsedPastedPathPayload
Unified parse result for dropped-path payload detection.
Class
MediaTracker
Track pasted images and videos in the current conversation.
Class
ApprovalMode
Tool-approval policy selected for an interactive thread.
Class
ApprovalModePayload
Stored approval-mode control payload.
Class
CharsetMode
Character set mode for TUI display.
Class
Glyphs
Character glyphs for TUI display.
Class
Settings
Global settings and environment detection for deepagents-code.
Class
LangsmithShadowResult
Why /trace found no LangSmith key, when an empty override is involved.
Class
TracingStatus
Offline snapshot of LangSmith tracing configuration for diagnostics.
Class
LangSmithLookupError
Base class for typed LangSmith project URL lookup failures.
Class
LangSmithImportError
The langsmith package is not installed.
Class
LangSmithLookupTimeoutError
The LangSmith project URL lookup exceeded its hard timeout.
Class
LangSmithApiError
The LangSmith SDK call raised — auth, 404, network, etc.
Class
LangSmithProjectNotFoundError
The LangSmith project does not exist yet (lookup returned 404).
Class
ModelResult
Result of creating a chat model, bundling the model with its metadata.
Class
MCPToolInfo
Metadata for a single MCP tool.
Class
MCPServerInfo
Metadata for a configured MCP server and its tools.
Class
MCPConfigError
An MCP configuration file is malformed or structurally invalid.
Class
MCPSessionManager
Lazy, per-server cache of persistent MCP sessions.
Class
ProjectServerSummary
A project MCP server row shown to the user and gated for trust.
Class
ApiKeyCredential
A persisted API key credential.
Class
OAuthCredential
A persisted OAuth subscription credential.
Class
WriteOutcome
Result of a credential write that may have warnings to surface.
Class
DeleteOutcome
Result of a credential delete that may have warnings to surface.
Class
OptionKind
How an option's raw env/TOML value is coerced to a typed value.
Class
ConfigOption
One user-tunable configuration option and where it can be set.
Class
CLIContextSchema
Declared context_schema for the agent graph.
Class
CLIContext
Client-facing builder for the per-run graph context payload.
Class
ManagedMemoryGuardMiddleware
Revert agent edits to the managed onboarding-name memory block.
Class
GoalStateProjection
Canonical goal/rubric fields used for notices and fingerprints.
Class
GoalStateNoticeInfo
Metadata extracted from a canonical goal-state notice.
Class
ModelConfigError
Raised when model configuration or creation fails.
Class
NoCredentialsConfiguredError
Raised when no credentials are configured for any default-resolvable provider.
Class
UnknownProviderError
Raised when neither the app nor init_chat_model can infer a provider.
Class
MissingCredentialsError
Raised when a provider is selected but its API key env var is unset.
Class
MissingProviderPackageError
Raised when a provider is selected but its LangChain package is not installed.
Class
ProviderAuthState
Credential readiness state for a model provider.
Class
ProviderAuthSource
Origin of a CONFIGURED credential, used to discriminate display.
Class
ProviderAuthStatus
Credential readiness information for a provider.
Class
ModelSpec
A model specification in provider:model format.
Class
ModelProfileEntry
Profile data for a model with override tracking.
Class
ProviderConfig
Configuration for a model provider.
Class
ModelConfig
Parsed model configuration from config.toml.
Class
McpProjectServerApproval
A project-scoped, definition-bound MCP server approval.
Class
McpServerTrustLists
User-level allow/deny lists for project MCP servers.
Class
ThreadConfig
Coalesced thread-selector configuration read from a single TOML parse.
Class
ExternalEvent
A transport-independent event delivered from outside the TUI.
Class
EventSource
Source of external events for the Textual app.
Class
UnixSocketEventSource
Line-delimited JSON event source over a local Unix domain socket.
Class
InMemoryLogRecord
Structured log record retained by the in-memory debug buffer.
Class
InMemoryLogBuffer
Logging handler retaining the most recent structured records in memory.
Class
ConfigErrorKind
Discriminator for ConfigResolutionError reasons.
Class
ConfigResolutionError
Structured error returned when a login target cannot be resolved.
Class
ConfigResolution
Successful resolution of a merged MCP config for login.
Class
ServerSelection
Resolved server config plus enough context for error messages.
Class
PathState
Whether a probed path exists, is absent, or could not be read.
Class
ConfigurableModelMiddleware
Swap the model or per-call settings from runtime.context.
Class
CostState
Agent state extended with the cumulative thread-cost channel.
Class
CostTrackingMiddleware
Own the thread's cumulative _session_cost_usd checkpoint value.
Class
ToolUsePayload
tool.use hook payload (schema documented in hooks).
Class
ToolErrorPayload
tool.error hook payload (schema documented in hooks).
Class
ToolResultPayload
tool.result hook payload (schema documented in hooks).
Class
ToolCallBuffer
In-progress state for a single streamed tool call.
Class
UnemittedToolCalls
Counts of buffered tool calls that never emitted a tool.use.
Class
DeterministicIntegrationChatModel
Deterministic chat model for integration tests.
Class
ToolCallingIntegrationChatModel
Deterministic tool-calling model for auto-approve integration tests.
Class
GoalCriteriaIntegrationChatModel
Exercise nested criteria generation with a repository read.
Class
RepositoryMetadata
Parsed origin remote attribution for coding-agent-v1 traces.
Class
TerminalProgressState
OSC 9;4 progress states.
Class
ActionId
Stable identifiers for notification actions dispatched by the app.
Class
NotificationAction
One button/action row in the notification modal.
Class
MissingDepPayload
Typed payload for a missing-dependency notification.
Class
UpdateAvailablePayload
Typed payload for an update-available notification.
Class
PendingNotification
A single notice waiting for user action.
Class
NotificationRegistry
In-memory store of pending notifications.
Class
ModelStats
Token stats for a single model within a session.
Class
KindStats
Token and cost stats for one UsageKind bucket.
Class
RecordedUsage
Usage returned after recording one streamed model message.
Class
SessionStats
Stats accumulated over a single agent turn (or full session).
Class
RecordedRequest
What a stream consumer last recorded for one request.
Class
RuntimeModelConfig
Active model configuration read from a tool runtime.
Class
CLICompactionMiddleware
Add hook-aware automatic and explicit forced compaction for dcode.
Class
Choice
A single choice option for a multiple choice question.
Class
Question
A question to ask the user.
Class
AskUserRequest
Request payload sent via interrupt when asking the user questions.
Class
AskUserAuthorizationReceipt
Trusted same-turn authorization recorded after an ask_user response.
Class
AskUserAnswered
Widget result when the user submits answers.
Class
AskUserCancelled
Widget result when the user cancels the prompt.
Class
ServerConfig
Full configuration payload passed from the app to the server subprocess.
Class
ChecksumMismatchError
Raised when a downloaded archive fails SHA-256 verification.
Class
ManagedToolUnavailableError
Raised when no managed helper binary is available for this system.
Class
PastedContent
Stored content for a collapsed paste.
Class
DiagnosticItem
A single labeled diagnostic fact.
Class
DiagnosticSection
A named group of related diagnostic items.
Class
ToolEntry
A single tool's display metadata.
Class
ToolGroup
A named group of tools sharing a source.
Class
UnavailableServer
An MCP server that was discovered but currently exposes no tools.
Class
ToolCatalog
Everything dcode tools list needs to render, in display order.
Class
ApprovalPreview
Data used to render HITL previews.
Class
FileOpMetrics
Line and byte level metrics for a file operation.
Class
FileOperationRecord
Track a single filesystem tool call.
Class
FileOpTracker
Collect file operation metrics during an interaction.
Class
ProjectContext
Explicit user/project path context for project-sensitive behavior.
Class
RubricGraderState
Nested-grader state used to scope verification-tool budgets.
Class
ReliableRubricMiddleware
Run a context-aware nested grader and retry transient transport failures.
Class
ThreadInfo
Thread metadata returned by list_threads.
Class
SubagentMetadata
Metadata for a custom subagent loaded from filesystem.
Class
DistributionVersion
Structured version facts for a single installed distribution.
Class
VersionReport
Network-free snapshot of the version facts diagnostics need.
Class
ExtrasIntrospectionError
Raised when installed extras cannot be determined safely.
Class
ExtraDependencyStatus
Install status for one optional dependency extra.
Class
InstallHint
Resolved recovery action for a missing provider package.
Class
UnicodeIssue
A dangerous Unicode character found in text.
Class
UrlSafetyResult
Safety analysis output for a URL string.
Class
McpServerSpec
Parsed MCP server config entry.
Class
FileTokenStorage
File-backed TokenStorage under ~/.deepagents/.state/mcp-tokens/.
Class
MCPReauthRequiredError
Raised when an MCP server needs interactive re-authentication.
Class
LocalContextState
State for local context middleware.
Class
LocalContextMiddleware
Inject local context (git state, project structure, etc.) into the system prompt.
Class
HookEngine
Execute Hooks v2 invocations against one immutable snapshot.
Class
HookSessionIdentity
Live client identity projected into every hook invocation.
Class
HookOutcome
Result of a lifecycle hook that may halt the caller.
Class
PromptOutcome
Result of UserPromptSubmit, including its prompt rewrites.
Class
HooksManager
Owns the Hooks v2 runtime, presenter, hook service, and transcripts.
Class
TranscriptRecord
One JSONL record in a materialized transcript projection.
Class
TranscriptHandle
Identity of a materialized transcript file.
Class
TranscriptStore
Append-only JSONL transcript projections owned by the client process.
Class
TranscriptRecorder
Collect completed stream messages into a Hooks transcript runtime.
Class
HookEnvelopeAdapter
Adapt hook invocations and handler output across the wire boundary.
Class
HandlerResult
Validated output and diagnostics from one command handler.
Class
HooksTrustEntry
Persisted trust record for one canonical workspace root.
Class
HooksTrustStore
Versioned on-disk trust store for project-scoped hooks.
Class
WorkspaceTrust
Decides whether project-scoped hooks may run in a given directory.
Class
HookHandler
One ordered command handler in a configuration snapshot.
Class
HookMatch
Matched handlers for one invocation.
Class
HooksSnapshot
Immutable, declaration-ordered Hooks v2 runtime configuration.
Class
HandlerType
Supported hook handler executor kinds.
Class
PlainOutputPolicy
How non-JSON stdout is treated on a successful exit.
Class
ExitCodePolicy
How exit code 2 is interpreted for an event.
Class
AggregationPolicy
How matching handler effects are combined.
Class
HookEventSpec
Immutable capability description for one hook event.
Class
PreparedHookInvocation
Client-only materialization needed to build one hook wire envelope.
Class
HooksRuntime
Client-owned session runtime around an immutable Hooks snapshot.
Class
HookFulfillmentLedger
Deduplicate hook fulfillment for one client session.
Class
HookInvocationInterrupt
LangGraph interrupt envelope for a server-owned hook invocation.
Class
HookNoticeCallback
Callable that surfaces a user-visible hook notice.
Class
HookStatusCallback
Callable that updates hook-owned transient status text.
Class
HookProgress
Lifecycle update for one running hook handler.
Class
HookPresenter
Present hook output consistently across interactive and headless clients.
Class
HooksSource
Origin of the matcher groups contributed by one hooks document.
Class
FileHooksSource
A project or user hooks file, which defines no variables.
Class
PluginHooksSource
Origin and environment for groups one enabled plugin contributed.
Class
LoadedHooksConfig
Validated configuration plus load diagnostics and source paths.
Class
ClientHookStopError
Raised when a client-owned hook stops lifecycle processing.
Class
ClientHookContext
Client state required to create a domain hook invocation.
Class
ClientHookService
Execute client-owned events and apply their common side effects.
Class
PermissionReviewDecision
Client approval decision compatible with HITL resume payloads.
Class
PermissionHookOutcome
Normalized result shared by TUI and headless permission handling.
Class
PermissionPlan
How one batch of gated tool calls was resolved by hooks.
Class
ServerHooksState
Agent state extensions for server-owned hook middleware.
Class
ServerHooksMiddleware
Emit server-owned lifecycle events over the hook interrupt transport.
Class
HookInvocationRequest
Request sent for a server-owned hook invocation.
Class
HookInvocationResponse
Response returned for a server-owned hook invocation.
Class
WirePermissionMode
Permission modes exposed by the compatible wire protocol.
Class
WireNotificationType
Notification matcher values exposed on the wire.
Class
Effort
Wire representation of model effort.
Class
PermissionRule
Permission rule returned by a hook.
Class
PermissionDestination
Configuration scope targeted by a permission update.
Class
AddRulesUpdate
Permission update that adds rules.
Class
ReplaceRulesUpdate
Permission update that replaces rules.
Class
RemoveRulesUpdate
Permission update that removes rules.
Class
SetModeUpdate
Permission update that changes the active mode.
Class
AddDirectoriesUpdate
Permission update that adds allowed directories.
Class
RemoveDirectoriesUpdate
Permission update that removes allowed directories.
Class
BackgroundTaskWire
Background task snapshot exposed to hook handlers.
Class
SessionCronWire
Scheduled session prompt exposed to hook handlers.
Class
BaseHookWireInput
Fields common to every hook input.
Class
SessionStartWireInput
Wire input for SessionStart.
Class
UserPromptSubmitWireInput
Wire input for UserPromptSubmit.
Class
SessionEndWireInput
Wire input for SessionEnd.
Class
PermissionRequestWireInput
Wire input for PermissionRequest.
Class
NotificationWireInput
Wire input for Notification.
Class
PreToolUseWireInput
Wire input for PreToolUse.
Class
PostToolUseWireInput
Wire input for PostToolUse.
Class
PostToolUseFailureWireInput
Wire input for PostToolUseFailure.
Class
PreCompactWireInput
Wire input for PreCompact.
Class
StopWireInput
Wire input for Stop.
Class
SubagentStartWireInput
Wire input for SubagentStart.
Class
SubagentStopWireInput
Wire input for SubagentStop.
Class
SessionStartSpecificOutput
Event-specific output for SessionStart.
Class
UserPromptSubmitSpecificOutput
Event-specific output for UserPromptSubmit.
Class
PreToolUseSpecificOutput
Event-specific output for PreToolUse.
Class
PermissionAllow
Permission-request output that allows a tool call.
Class
PermissionDeny
Permission-request output that denies a tool call.
Class
PermissionRequestSpecificOutput
Event-specific output for PermissionRequest.
Class
PostToolUseSpecificOutput
Event-specific output for PostToolUse.
Class
PostToolUseFailureSpecificOutput
Event-specific output for PostToolUseFailure.
Class
StopSpecificOutput
Event-specific output for Stop.
Class
SubagentStartSpecificOutput
Event-specific output for SubagentStart.
Class
SubagentStopSpecificOutput
Event-specific output for SubagentStop.
Class
HookWireOutput
Compatible hook output with retained extension fields.
Class
CommandHandlerSpec
Configuration for a synchronous command hook.
Class
MatcherGroup
A matcher and its ordered hook handlers.
Class
HooksConfig
Top-level configuration grouped by hook event.
Class
HookEvent
Supported hook lifecycle events.
Class
HookOwner
Process responsible for originating an event.
Class
SessionStartCause
Reason a session-start event occurred.
Class
SessionEndCause
Reason a session-end event occurred.
Class
DcodeNotificationKind
dcode lifecycle notifications with compatible wire mappings.
Class
CompactTrigger
Reason context compaction was requested.
Class
ToolCallData
Native tool-call data used by hook lifecycle owners.
Class
AgentIdentity
Resolved subagent identity.
Class
DcodeNotification
A notification emitted by a dcode lifecycle owner.
Class
BackgroundTaskSnapshot
Background task state captured for a hook invocation.
Class
SessionCronSnapshot
Scheduled session prompt captured for a hook invocation.
Class
HookContext
Context shared by every domain hook event.
Class
SessionStartEvent
Domain payload for SessionStart.
Class
UserPromptSubmitEvent
Domain payload for UserPromptSubmit.
Class
SessionEndEvent
Domain payload for SessionEnd.
Class
PermissionRequestEvent
Domain payload for PermissionRequest.
Class
NotificationEvent
Domain payload for Notification.
Class
PreToolUseEvent
Domain payload for PreToolUse.
Class
PostToolUseEvent
Domain payload for PostToolUse.
Class
PostToolUseFailureEvent
Domain payload for PostToolUseFailure.
Class
PreCompactEvent
Domain payload for PreCompact.
Class
StopEvent
Domain payload for Stop.
Class
SubagentStartEvent
Domain payload for SubagentStart.
Class
SubagentStopEvent
Domain payload for SubagentStop.
Class
HookInvocation
A domain hook event with its invocation context.
Class
HookDiagnostic
Structured diagnostic produced while processing a hook.
Class
PermissionEffect
Normalized permission result from hook processing.
Class
BaseHookDecision
Fields common to every event-specific hook decision.
Class
SessionStartDecision
Decision returned for SessionStart.
Class
UserPromptSubmitDecision
Decision returned for UserPromptSubmit.
Class
SessionEndDecision
Decision returned for SessionEnd.
Class
PermissionRequestDecision
Decision returned for PermissionRequest.
Class
NotificationDecision
Decision returned for Notification.
Class
PreToolUseDecision
Decision returned for PreToolUse.
Class
PostToolUseDecision
Decision returned for PostToolUse.
Class
PostToolUseFailureDecision
Decision returned for PostToolUseFailure.
Class
PreCompactDecision
Decision returned for PreCompact.
Class
StopDecision
Decision returned for Stop.
Class
SubagentStartDecision
Decision returned for SubagentStart.
Class
SubagentStopDecision
Decision returned for SubagentStop.
Class
HookEffect
Normalized effect produced by one hook handler.
Class
MarketplaceError
Raised when a marketplace cannot be loaded.
Class
PluginManifestError
Raised when a plugin manifest is malformed enough to skip the plugin.
Class
PluginStateError
Raised when existing plugin state cannot be safely modified.
Class
LocalMarketplaceSource
Local directory or JSON file used as a marketplace source.
Class
RepositoryMarketplaceSource
GitHub or Git repository used as a marketplace source.
Class
UrlMarketplaceSource
Marketplace manifest downloaded from an HTTP URL.
Class
PluginManifest
Parsed plugin manifest.
Class
ComponentInventory
Inventory of supported plugin components.
Class
PluginInstance
A discovered plugin ready to feed dcode adapters.
Class
LocalPluginSource
A plugin stored relative to its marketplace.
Class
GithubPluginSource
A plugin sourced from a GitHub repository.
Class
GitSubdirectoryPluginSource
A plugin sourced from a subdirectory in a Git repository.
Class
UrlPluginSource
A plugin sourced from a Git repository URL.
Class
MarketplacePluginEntry
A catalog entry from a marketplace manifest.
Class
PluginMarketplace
A parsed marketplace manifest.
Class
MarketplaceRecord
Persisted marketplace source record.
Class
InstalledPluginEntry
Install record for a plugin.
Class
PluginDiscoveryResult
Result from plugin discovery.
Class
PluginSkillsMiddleware
Load namespaced plugin skills without extending the SDK source API.
Class
RevokeResult
Outcome of a revoke_skill_dir_trust call.
Class
ExtendedSkillMetadata
Extended skill metadata for CLI display, adds source tracking.
Class
SkillInvocationEnvelope
Structured prompt and checkpoint metadata for a skill invocation.
Class
DeferredToolResultHook
A tool.result payload held back until the authoritative result arrives.
Class
RubricEvaluationEnd
A validated rubric_evaluation_end event forwarded to the caller.
Class
TextualUIAdapter
Adapter for rendering agent output to Textual widgets.
Class
ResumeCompactPromptScreen
Ask whether to compact a just-resumed thread before the next turn.
Class
PluginManagerScreen
Arrow-key navigable plugin manager for /plugins.
Class
PluginTabSelected
Posted when a plugin manager tab label is clicked.
Class
PluginTabLabel
Mouse-clickable tab label in the plugin manager header.
Class
WelcomeBanner
Compact welcome banner shown at startup.
Class
AutoModeNoticeScreen
In-TUI first-run notice describing what Auto mode does.
Class
JsEvalStdout
Captured stdout printed during a js_eval evaluation.
Class
JsEvalResult
A successful js_eval evaluation result.
Class
JsEvalError
An error raised during a js_eval evaluation.
Class
InlinePromptCompletion
Resolve an inline prompt result at most once.
Class
InlinePromptTextArea
Soft-wrapping text input shared by inline prompts.
Class
Submitted
Posted when the user presses Enter to submit text.
Class
InlinePromptOption
Render a selectable inline-prompt option with a cursor.
Class
NotificationSettingsScreen
Modal dialog for managing warning preferences.
Class
MessageType
Types of messages in the chat.
Class
ToolStatus
Status of a tool call.
Class
MessageData
In-memory message data for virtualization.
Class
MessageStore
Manages message data and widget window for virtualization.
Class
SkillTrustScreen
Approval overlay for a skill resolving outside trusted directories.
Class
AskUserTextArea
Free-form answer input for ask-user questions.
Class
Submitted
Posted when the user presses Enter to submit an ask-user answer.
Class
AskUserMenu
Interactive widget for asking the user questions.
Class
Answered
Message sent when user submits all answers.
Class
Cancelled
Message sent when user cancels the ask_user prompt.
Class
ModelOption
A clickable model option in the selector.
Class
Clicked
Message sent when a model option is clicked.
Class
ModelSelectorScreen
Full-screen modal for model selection.
Class
PasteBurstTextArea
TextArea that detects paste-like keystroke bursts.
Class
CollapsingPasteTextArea
Paste-aware text area that collapses large pastes into placeholders.
Class
UpdateProgressScreen
Modal that shows self-update progress and a bounded log tail.
Class
FormattedOutput
Result of formatting tool output for display.
Class
UserMessage
Widget displaying a user message.
Class
ExpansionChanged
Posted when the collapsed-body expansion state changes.
Class
QueuedUserMessage
Widget displaying a queued (pending) user message in grey.
Class
SkillMessage
Widget displaying a skill invocation with collapsible body.
Class
AssistantMessage
Widget displaying an assistant message with markdown support.
Class
ToolCallMessage
Widget displaying a tool call with collapsible output.
Class
ToolGroupSummary
Collapsed one-line stand-in for an assistant step's tool calls.
Functions
Modules
Types
Class
CwdSwitchPromptScreen
Modal asking whether to switch cwd when resuming or switching to a thread.
Class
HITLIterationLimitError
Raised when the HITL interrupt loop exceeds _MAX_HITL_ITERATIONS rounds.
Function
classifier_unavailable_reason
Build a safe agent/UI reason for a failed auto classifier call.
Function
format_release_age_parenthetical
Return " (released Nd ago)" for version, or "" when unknown.
Function
format_sdk_release_age
Return a human-readable age for SDK version (e.g., 'released 3d ago').
Function
read_approval_mode_from_store
Read a live approval mode from the server-side LangGraph Store.
Function
resolve_auto_classifier_model
Resolve the model spec the Auto approval classifier should use.
Function
fetch_langsmith_project_url_or_raise
Fetch the LangSmith project URL, raising on any failure.
Function
validate_model_capabilities
Validate that the model has required capabilities for deepagents.
Function
load_merged_mcp_configs_lenient
Load and validate project configs after resolving precedence.
Function
normalize_tool_status
Map a raw ToolMessage.status to the two-value hook domain, fail-closed.
Function
reset_terminal_background
Reset the terminal's dynamic default background color with OSC 111.
Function
collect_sdk_version_info
Collect version facts for the installed deepagents SDK distribution.
Function
sanitize_control_chars
Neutralize control characters and deceptive Unicode in untrusted text.
Function
materialize_plugin_source
Resolve or materialize a marketplace plugin entry to a plugin root.
Function
discover_plugin_skill_state
Discover plugin skill sources, containment roots, and loaded ids.