Skip to main content

Crate mur_common

Crate mur_common 

Source

Re-exports§

pub use actor::Actor;
pub use actor::ActorSource;
pub use conversation::CONVERSATION_SCHEMA_VERSION;
pub use conversation::Content;
pub use conversation::Message;
pub use conversation::Role;
pub use conversation::Source;
pub use hooks_config::HooksConfig;
pub use pattern::Pattern;
pub use removable_volume::REMOVABLE_VOLUME_EPERM_HINT;
pub use scope::Scope;
pub use signal::SIGNAL_SCHEMA_VERSION;
pub use signal::Signal;
pub use signal::SignalBatch;
pub use signal::SignalBatchResponse;
pub use signal::SignalKind;
pub use signal::SignalTarget;
pub use a2a::Message as A2aMessage;
pub use a2a::JsonRpcError;
pub use a2a::JsonRpcRequest;
pub use a2a::JsonRpcResponse;
pub use a2a::Task;
pub use a2a::TaskState;
pub use agent::AgentAppearance;
pub use agent::AgentProfile;
pub use agent::BehaviorPreset;
pub use agent::DeploymentConfig;
pub use agent::DeploymentType;
pub use agent::Entitlements;
pub use agent::ExecutionMode;
pub use agent::FederationConfig;
pub use agent::FileTransferConfig;
pub use agent::HitlConfig;
pub use agent::IdentityConfig;
pub use agent::LockFile;
pub use agent::PatternFilter;
pub use agent::Persona;
pub use agent::PersonaCategory;
pub use agent::RenderStatus;
pub use agent::RetryPolicy;
pub use agent::ScheduleEntry;
pub use agent::SnapshotPolicy;
pub use agent::SnapshotRef;
pub use agent_name::AgentNameError;
pub use agent_name::MAX_AGENT_NAME_LEN;
pub use agent_name::validate_agent_name;
pub use bridge::LlmEntitlement;
pub use bridge::LlmMode;
pub use channel::CHANNEL_SCHEMA_VERSION;
pub use channel::Channel;
pub use channel::ChannelActor;
pub use channel::ChannelEvent;
pub use channel::ChannelState;
pub use channel::EventKind;
pub use channel::Goal;
pub use channel::Participant;
pub use channel::ParticipantRole;
pub use identity::AgentIdentity;
pub use identity::ChainError;
pub use identity::ChainOptions;
pub use identity::ChainOutcome;
pub use identity::IdentityError;
pub use identity::RotationAttestation;
pub use identity::RotationReason;
pub use identity::decode_pubkey;
pub use identity::encode_pubkey;
pub use identity::verify_chain;
pub use manifest::AgentManifest;

Modules§

a2a
A2A v0.3 protocol envelope types.
action
actor
agent
Agent profile, Agent Card, and LockFile types shared between mur-agent-runtime and mur-core.
agent_facts
Dispatch index: derived facts about the agents and fleets on this machine.
agent_name
Canonical agent-name validation. Used by both mur agent create (CLI) and the /api/v1/agents/{name} HTTP routes so the two surfaces never disagree on what names are valid.
binary_attestation
Binary attestation: verify that a spawned mur-agent-runtime carries a valid signature from MUR’s Developer ID team (launch-chain follow-on, spec 2026-08-12). Gated to release builds by the build marker.
bridge
Bridge-related shared types.
build
Compile-time build identity. SHORT_SHA is the git commit the binary was built from (set by build.rs), or “unknown” for git-less builds (crates.io). Used to detect when a running agent’s binary differs from the installed one.
bundle
Wire-format types shared between the GUI export pipeline (writer) and the GUI app’s first-launch bootstrap (reader).
canonical
Canonical JSON serialization (sorted keys, no whitespace).
capability
A Capability: a standalone-installable bundle of MCP server(s) + skill refs + external-program requirements + suggested entitlements. Reuses the existing agent primitives; installed into an agent’s profile.
channel
Pure Channel types — no I/O; store logic lives in the mur-channel crate.
commander
companion
Companion subsystem shared types (Phase 1.1).
config
config_migrate
One-shot migration of the legacy conversations model fields.
conversation
Shared conversation archive types (used by mur-core, mur-commander).
coordination
Coordination protocol types for multi-step agent workflows.
deps
Portable program dependencies: declaring, detecting, and (curated) installing the external programs a shared MUR artifact needs. See docs/superpowers/specs/2026-07-11-portable-program-dependencies-design.md
error
Typed errors for MUR library boundaries.
eval
B0 M11 — JSONL output schema for the eval harness. B0 M11 — eval-harness output schema.
event
exec
Shared executable-path resolution.
expression
Shared expression-change type used by both Hub and sidecar runtimes.
fleet
Fleet — a named squad of agents working a shared goal over one channel.
fleet_bundle
.fleet bundle manifest types + signing primitives (pure; no I/O).
guard
hitl
Risk-tiered HITL vocabulary shared across the executor, runtime, and surfaces.
hooks_config
hub
identity
Per-agent Ed25519 identity keypair.
jcs
RFC 8785 JSON Canonicalization Scheme (JCS).
knowledge
KnowledgeBase — the shared foundation for patterns and workflows.
labels
Fleet labels — a central, many-to-many taxonomy over fleets.
ledger
llm
local_llm
Location and accessors for the bundled local-model base URL.
lock_file
Canonical running.lock reader + 3-state agent status classifier.
manifest
AgentManifest — declarative K8s-style spec for creating/updating an agent.
mcp_naming
MCP wire-name encoding: mcp__<server>__<tool>.
mcp_package
Package specs for interpreter-launched MCP servers.
media
Shared media runtime types + small leaf helpers. Consumed by both mur-core (VLC control, media tools) and mur-agent-runtime (WatchScheduler), which cannot depend on mur-core — so the snapshot-selection and VLC-status-parsing logic that both need lives here rather than being duplicated.
mobile
Wire protocol for the MUR mobile app ↔ Mac daemon WebSocket endpoint.
model
Named model registry shared by all agents.
model_resolve
First-run model-resolution decision tree (spec §7.3). Pure logic shared by the CLI (Plan 1b) and the Hub GUI wizard (Plan 2). Hardware detection and the actual pull/key-entry actions live in the surface layers; this module only decides the recommended default given a hint + hardware.
multimodal
muragent
.muragent v2 portable agent package format.
net
Shared host-pattern matcher for outbound-network allow/deny checks.
official
Official catalog license — pure types + signing/verification (no I/O).
panel
Wire protocol + on-disk session records for the murmur Panel (companion window). Shared by the murmur TUI (socket server side) and mur-gui-core::panel_bridge (Hub client side). One JSON object per line. Design: docs/superpowers/specs/2026-07-05-murmur-panel-companion-design.md
parallel
Parallel tracks config — extends fleet.yaml parallel: section.
parameterize
Auto-detection of parameterizable values in workflow exports.
paths
Directory names under <mur_home> that a fleet / deep-research run writes.
pattern
permissions
Permission grants and audit log for the AskUser flow.
pipeline
Pipeline expression AST and parser.
project
Canonical project identity for skill scope: Project matching.
redact
One redaction chokepoint, shared by every writer that puts text on disk.
removable_volume
Shared, logic-free constants for the macOS removable-volume (external disk) Full-Disk-Access failure mode (issue #1).
route
Route data types for the cost-router orchestrator.
schedule
Schedule — unified schedule definitions shared between mur CLI and Commander.
schedule_claim
Schedule claim/release — prevents double execution between CLI cron and Commander.
scope
secret
Typed reference to a secret value. The reference itself is safe to commit / log / serialize; the resolved value (SecretString) is zeroized on drop.
signal
Signal wire format for cross-process memory sync events.
skill
MuR skill ecosystem — see docs/superpowers/specs/2026-05-24-mur-skill-ecosystem-design.md.
snapshot_request
Signed snapshot-pull request — the agent-side half of the memory-federation pull leg (spec: docs/superpowers/specs/2026-08-04-unified-memory-federation.md). An agent runtime writes one (YAML, tmp+rename) into <mur_home>/inbox/snapshot-requests/; the daemon verifies it against the agent’s on-disk pubkey and assembles the snapshot central-side. Canonical sign-input EXCLUDES sig (v3d ChannelEvent precedent).
sync_types
Typed DTOs for cloud sync API (Go server).
telemetry
OpenTelemetry GenAI semantic conventions (Q1 2026 Development status, gated by OTEL_SEMCONV_STABILITY_OPT_IN=gen_ai_latest_experimental) plus murmur-specific extensions.
trust
Shared trust store at ~/.mur/trust/trust.yaml.
variable
Variable system — user-defined variables with {{var_name}} template syntax.
workflow
Workflow — a reusable sequence of steps captured from sessions.
zfs_protocol