internal/

directory
v0.700.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Sep 1, 2026 License: MIT

Directories

Path Synopsis
Package agentsmd builds the prompt used by the /improve-agents-md slash command.
Package agentsmd builds the prompt used by the /improve-agents-md slash command.
Package agentvcs implements a minimal jj-inspired version control system for tracking file changes across agent sessions.
Package agentvcs implements a minimal jj-inspired version control system for tracking file changes across agent sessions.
Package agui implements the AG-UI protocol (Agent-User Interaction Protocol, https://docs.ag-ui.com) as an isolated side-car adapter on top of Pando.
Package agui implements the AG-UI protocol (Agent-User Interaction Protocol, https://docs.ag-ui.com) as an isolated side-car adapter on top of Pando.
Package browser resolves which Chromium-family browser Pando should drive.
Package browser resolves which Chromium-family browser Pando should drive.
Package caveman implements an output-brevity policy that can be injected into the agent's system prompt before each turn, at three levels (lite/full/ultra) plus an off switch.
Package caveman implements an output-brevity policy that can be injected into the agent's system prompt before each turn, at three levels (lite/full/ultra) plus an off switch.
Package commands provides a shared registry of slash commands used across ACP, TUI, and WebUI interfaces.
Package commands provides a shared registry of slash commands used across ACP, TUI, and WebUI interfaces.
Package config manages application configuration from various sources.
Package config manages application configuration from various sources.
Package convert wraps the conductor-oss/markitdown pure-Go library to turn rich document formats (docx, pdf, xlsx, …) into Markdown.
Package convert wraps the conductor-oss/markitdown pure-Go library to turn rich document formats (docx, pdf, xlsx, …) into Markdown.
Package design implements Pando's Design Studio: HTML/CSS/JS design artifacts that agents build, render, inspect and iterate on.
Package design implements Pando's Design Studio: HTML/CSS/JS design artifacts that agents build, render, inspect and iterate on.
preview
Package preview serves design artifacts over HTTP so every surface — the WebUI iframe, a system browser opened from the TUI, a Zed resource link — looks at the same running document instead of a file:// copy.
Package preview serves design artifacts over HTTP so every surface — the WebUI iframe, a system browser opened from the TUI, a Zed resource link — looks at the same running document instead of a file:// copy.
Package desktop contains the Wails desktop application wrapper for Pando.
Package desktop contains the Wails desktop application wrapper for Pando.
Package extensions is the host side of the extension system: it adapts Pando's internal configuration and services to the public contract declared in pkg/extension, and builds the process-wide extension manager.
Package extensions is the host side of the extension system: it adapts Pando's internal configuration and services to the public contract declared in pkg/extension, and builds the process-wide extension manager.
Package imageopt provides a single, reusable image normalization pipeline used before images are sent to LLM providers, both for user attachments and for tool-result images (e.g.
Package imageopt provides a single, reusable image normalization pipeline used before images are sent to LLM providers, both for user attachments and for tool-result images (e.g.
ipc
bridge
Package bridge connects in-process pubsub events to the ZMQ Bus, enabling real-time event broadcasting to all connected Pando instances and observers.
Package bridge connects in-process pubsub events to the ZMQ Bus, enabling real-time event broadcasting to all connected Pando instances and observers.
changepub
Package changepub publishes write-change events on the IPC PUB socket after every successful DB write on the primary instance, allowing secondaries to invalidate caches and refresh views without polling.
Package changepub publishes write-change events on the IPC PUB socket after every successful DB write on the primary instance, allowing secondaries to invalidate caches and refresh views without polling.
dbproxy
Package dbproxy provides a db.Querier implementation that transparently routes write operations while keeping reads fast.
Package dbproxy provides a db.Querier implementation that transparently routes write operations while keeping reads fast.
failover
Package failover monitors primary liveness and promotes a secondary instance when the primary dies or shuts down gracefully.
Package failover monitors primary liveness and promotes a secondary instance when the primary dies or shuts down gracefully.
runtime
Package runtime encapsulates the unified IPC bootstrap sequence that every Pando entrypoint must follow: derive ports, try the lock, open RW or RO DB, and wire services accordingly.
Package runtime encapsulates the unified IPC bootstrap sequence that every Pando entrypoint must follow: derive ports, try the lock, open RW or RO DB, and wire services accordingly.
writecoordinator
Package writecoordinator serialises all SQLite write operations through a single goroutine, eliminating concurrent write contention on the primary instance and providing a natural chokepoint for metrics and backpressure.
Package writecoordinator serialises all SQLite write operations through a single goroutine, eliminating concurrent write contention on the primary instance and providing a natural chokepoint for metrics and backpressure.
Package learning implements Pando's opt-in "learner and documentarian" session mode: a per-session policy that makes the agent lean much harder on the knowledge base and memory subsystem, capture non-trivial discoveries as living documentation, actively ask the user what it needs to know, and keep existing documentation honest (updating stale docs and marking superseded ones outdated).
Package learning implements Pando's opt-in "learner and documentarian" session mode: a per-session policy that makes the agent lean much harder on the knowledge base and memory subsystem, capture non-trivial discoveries as living documentation, actively ask the user what it needs to know, and keep existing documentation honest (updating stale docs and marking superseded ones outdated).
llm
evaluatortools
Package evaluatortools provides MCP tool wrappers for Pando's self-improvement evaluator subsystem.
Package evaluatortools provides MCP tool wrappers for Pando's self-improvement evaluator subsystem.
models/modelsdev
Package modelsdev provides read-only access to the models.dev catalog (https://github.com/anomalyco/models.dev), a community-maintained database of model pricing and capabilities per provider.
Package modelsdev provides read-only access to the models.dev catalog (https://github.com/anomalyco/models.dev), a community-maintained database of model pricing and capabilities per provider.
tools/outputfilter
Package outputfilter implements an RTK-style declarative output-compression engine.
Package outputfilter implements an RTK-style declarative output-compression engine.
tools/readmode
Package readmode implements the smart file-read fidelity tiers used by the `view` tool (lean-ctx context-intelligence Phase 1) plus the helpers for the content-hash unchanged-re-read deduplication (Phase 2).
Package readmode implements the smart file-read fidelity tiers used by the `view` tool (lean-ctx context-intelligence Phase 1) plus the helpers for the content-hash unchanged-re-read deduplication (Phase 2).
lsp
Generated code.
Generated code.
runtime
Package runtime discovers the JavaScript toolchain installed on the host and provisions npm-distributed language servers on demand.
Package runtime discovers the JavaScript toolchain installed on the host and provisions npm-distributed language servers on demand.
Package mcpauth implements Phase 2 of the MCP client authentication plan: persistent OAuth 2.1 credential storage and a process-wide manager that builds mcp-go transport.OAuthConfig values from Pando's declarative config.MCPAuth blocks.
Package mcpauth implements Phase 2 of the MCP client authentication plan: persistent OAuth 2.1 credential storage and a process-wide manager that builds mcp-go transport.OAuthConfig values from Pando's declarative config.MCPAuth blocks.
mesnada
acp
Package acp provides types and utilities for working with the Agent Client Protocol.
Package acp provides types and utilities for working with the Agent Client Protocol.
agent
Package agent handles spawning and managing CLI agent processes.
Package agent handles spawning and managing CLI agent processes.
breaker
Package breaker implements the delegated-task circuit breaker and respawn guard: the anti-thrash layer that decides whether a task may be re-executed.
Package breaker implements the delegated-task circuit breaker and respawn guard: the anti-thrash layer that decides whether a task may be re-executed.
conclusion
Package conclusion implements the delegated-task conclusion protocol: parsing the sentinel <pando:conclusion> block emitted by a subagent and enriching it with software-owned launch metadata.
Package conclusion implements the delegated-task conclusion protocol: parsing the sentinel <pando:conclusion> block emitted by a subagent and enriching it with software-owned launch metadata.
config
Package mesnadaconfig handles Mesnada application configuration.
Package mesnadaconfig handles Mesnada application configuration.
events
Package events provides a durable, append-only log of delegation signals with cursor-based, at-least-once delivery.
Package events provides a durable, append-only log of delegation signals with cursor-based, at-least-once delivery.
orchestrator
Package orchestrator coordinates agent tasks and dependencies.
Package orchestrator coordinates agent tasks and dependencies.
persona
Package persona handles loading and managing persona definitions.
Package persona handles loading and managing persona definitions.
persona/builtin
Package builtin provides embedded built-in persona definitions.
Package builtin provides embedded built-in persona definitions.
server
Package server implements the MCP server with HTTP Streamable and stdio transports.
Package server implements the MCP server with HTTP Streamable and stdio transports.
store
Package store provides task persistence and retrieval.
Package store provides task persistence and retrieval.
ui
oauth
Package ponytail implements a "lazy senior developer" instruction set that can be injected into the agent's system prompt before each turn, at three intensity levels (lite/full/ultra) plus an off switch.
Package ponytail implements a "lazy senior developer" instruction set that can be injected into the agent's system prompt before each turn, at three intensity levels (lite/full/ultra) plus an off switch.
rag
Package rag provides the RemembrancesService that bundles KB, Events, and Code indexing.
Package rag provides the RemembrancesService that bundles KB, Events, and Code indexing.
code
Package code provides tree-sitter based code indexing with semantic search.
Package code provides tree-sitter based code indexing with semantic search.
embeddings
Package embeddings provides a unified interface for generating embeddings from multiple providers (OpenAI, Google, Ollama, Anthropic/Voyage).
Package embeddings provides a unified interface for generating embeddings from multiple providers (OpenAI, Google, Ollama, Anthropic/Voyage).
events
Package events provides temporal event storage with semantic search capabilities.
Package events provides temporal event storage with semantic search capabilities.
kb
Package kb provides a knowledge base system for storing and searching documents.
Package kb provides a knowledge base system for storing and searching documents.
proxy
Package proxy provides the server-side IPC dispatcher for Remembrances write operations (KB, Events, Code indexing).
Package proxy provides the server-side IPC dispatcher for Remembrances write operations (KB, Events, Code indexing).
treesitter
Package treesitter provides AST walking and symbol extraction utilities.
Package treesitter provides AST walking and symbol extraction utilities.
Package remoteview provides types for observing and controlling remote Pando instances over the IPC ZeroMQ bus.
Package remoteview provides types for observing and controlling remote Pando instances over the IPC ZeroMQ bus.
Package runtime defines abstractions for executing commands and accessing the filesystem in different isolation environments (host, docker, podman, etc.).
Package runtime defines abstractions for executing commands and accessing the filesystem in different isolation environments (host, docker, podman, etc.).
Package savings implements the append-only token-savings ledger (lean-ctx context-intelligence Phase 5).
Package savings implements the append-only token-savings ledger (lean-ctx context-intelligence Phase 5).
od
Package od carries OpenDesign's `od:` skill-frontmatter namespace, kept verbatim so a bundle written for either tool loads in the other.
Package od carries OpenDesign's `od:` skill-frontmatter namespace, kept verbatim so a bundle written for either tool loads in the other.
Package snapshot provides a service for capturing and comparing point-in-time snapshots of the working directory file system.
Package snapshot provides a service for capturing and comparing point-in-time snapshots of the working directory file system.
Package superpowers implements Pando's opt-in disciplined development workflow: a per-session policy that forces long or risky work through an explicit lifecycle (clarify/design -> approved plan -> test-first implementation -> verification/review -> explicit finish) before any code is changed.
Package superpowers implements Pando's opt-in disciplined development workflow: a per-session policy that forces long or risky work through an explicit lifecycle (clarify/design -> approved plan -> test-first implementation -> verification/review -> explicit finish) before any code is changed.
Package tlsutil generates and manages TLS certificates for Pando's HTTP server.
Package tlsutil generates and manages TLS certificates for Pando's HTTP server.
Package toolmeta provides shared tool-call metadata helpers used by both the ACP prompt handler and the WebUI SSE handler.
Package toolmeta provides shared tool-call metadata helpers used by both the ACP prompt handler and the WebUI SSE handler.
tui
components/instances
Package instances provides a Bubble Tea component for browsing and interacting with remote Pando instances in a two-panel layout:
Package instances provides a Bubble Tea component for browsing and interacting with remote Pando instances in a two-panel layout:
Package uiauto is the Pando Desktop Controller: it wires the platform-independent internal/uiauto/core building blocks (Element, Selector, Locator, SnapshotStore, Backend, ActionResolver, ...) to a concrete accessibility backend and exposes a single Manager the desktop_* agent tools drive.
Package uiauto is the Pando Desktop Controller: it wires the platform-independent internal/uiauto/core building blocks (Element, Selector, Locator, SnapshotStore, Backend, ActionResolver, ...) to a concrete accessibility backend and exposes a single Manager the desktop_* agent tools drive.
core
Package core provides the platform-independent building blocks of the Pando Desktop Controller: a normalized accessibility-tree element model, a selector DSL, snapshot/ref bookkeeping, action resolution and rendering for LLM consumption.
Package core provides the platform-independent building blocks of the Pando Desktop Controller: a normalized accessibility-tree element model, a selector DSL, snapshot/ref bookkeeping, action resolution and rendering for LLM consumption.
events
Package events defines the backend-agnostic UI event subscription model for the Pando Desktop Controller.
Package events defines the backend-agnostic UI event subscription model for the Pando Desktop Controller.
input
Package input implements the cross-platform physical (synthetic) mouse/keyboard input layer of the Pando Desktop Controller.
Package input implements the cross-platform physical (synthetic) mouse/keyboard input layer of the Pando Desktop Controller.
platform/browser
Package browser implements the Chrome DevTools Protocol accessibility backend (registered as "cdp") for the Pando Desktop Controller (internal/uiauto): when the UI in question is a Chrome/Edge/Chromium page, it serves the normalized core.Element model straight from the CDP Accessibility/DOM domains of an already-running browser session, instead of the OS accessibility API.
Package browser implements the Chrome DevTools Protocol accessibility backend (registered as "cdp") for the Pando Desktop Controller (internal/uiauto): when the UI in question is a Chrome/Edge/Chromium page, it serves the normalized core.Element model straight from the CDP Accessibility/DOM domains of an already-running browser session, instead of the OS accessibility API.
platform/darwin
Package darwin implements the macOS AXUIElement core.Backend ("ax") for the Pando Desktop Controller, described in Phase 5 of pando/plans/desktop_controller_uiauto_plan.md.
Package darwin implements the macOS AXUIElement core.Backend ("ax") for the Pando Desktop Controller, described in Phase 5 of pando/plans/desktop_controller_uiauto_plan.md.
platform/linux
Package linux implements the Linux AT-SPI2 accessibility backend for the Pando Desktop Controller (internal/uiauto).
Package linux implements the Linux AT-SPI2 accessibility backend for the Pando Desktop Controller (internal/uiauto).
platform/windows
Package windows implements the Windows UI Automation (UIA) accessibility backend for the Pando Desktop Controller (internal/uiauto), Phase 4 of [pando/plans/desktop_controller_uiauto_plan.md].
Package windows implements the Windows UI Automation (UIA) accessibility backend for the Pando Desktop Controller (internal/uiauto), Phase 4 of [pando/plans/desktop_controller_uiauto_plan.md].
portal
Package portal implements the shared plumbing for talking to the XDG desktop portal (org.freedesktop.portal.Desktop) that internal/uiauto's Linux Wayland input (internal/uiauto/input) and screen capture (internal/uiauto/screen) packages both need: the well-known bus/object names, org.freedesktop.portal.Request handle-token generation and Response-signal handling, response-code -> core.DesktopError mapping, and consent timeouts.
Package portal implements the shared plumbing for talking to the XDG desktop portal (org.freedesktop.portal.Desktop) that internal/uiauto's Linux Wayland input (internal/uiauto/input) and screen capture (internal/uiauto/screen) packages both need: the well-known bus/object names, org.freedesktop.portal.Request handle-token generation and Response-signal handling, response-code -> core.DesktopError mapping, and consent timeouts.
screen
Package screen implements the cross-platform screen capture layer of the Pando Desktop Controller, used by Manager.Screenshot (internal/uiauto/manager.go).
Package screen implements the cross-platform screen capture layer of the Pando Desktop Controller, used by Manager.Screenshot (internal/uiauto/manager.go).
vision
Package vision implements the Pando Desktop Controller's vision-fallback path: when a region of the screen exposes no usable accessibility semantics (a canvas app, a remote desktop window, a game, an app with a broken accessibility implementation), the agent still needs a way to act.
Package vision implements the Pando Desktop Controller's vision-fallback path: when a region of the screen exposes no usable accessibility semantics (a canvas app, a remote desktop window, a game, an app with a broken accessibility implementation), the agent still needs a way to act.
Package userinput provides a blocking question/answer service that lets the agent ask the user structured, selectable questions mid-task and wait for the response.
Package userinput provides a blocking question/answer service that lets the agent ask the user structured, selectable questions mid-task and wait for the response.
Package vulnhunter builds the prompts used by the security-audit slash commands (/vulnhunt, /vulnhunter-fix, /vulnhunt-fix-verify).
Package vulnhunter builds the prompts used by the security-audit slash commands (/vulnhunt, /vulnhunter-fix, /vulnhunt-fix-verify).

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL