wire/
lib.rs

1// This Source Code Form is subject to the terms of the Mozilla Public
2// License, v. 2.0. If a copy of the MPL was not distributed with this
3// file, You can obtain one at https://mozilla.org/MPL/2.0/.
4// Copyright (c) 2026 2youg1 and the sprawling contributors
5
6//! Process boundary: Command/Query/Event wire, WebSocket server, auth,
7//! read-only multi-city aggregation.
8//!
9//! The kernel types that appear on this crate's own signatures are
10//! re-exported below. The client reads the wire and nothing else
11//! (ARCHITECTURE section 8), so a client that cannot name `EventRecord`
12//! cannot read the frames it is sent; a boundary crate that hands out
13//! frames owes the vocabulary to read them.
14
15mod aggregate;
16mod answer;
17#[cfg(feature = "server")]
18mod assets;
19mod auth;
20mod carried_name;
21mod command;
22mod control;
23mod frames;
24mod guide;
25mod named_frames;
26mod preference;
27mod privacy;
28mod reading;
29#[cfg(feature = "server")]
30mod reception;
31mod reply;
32#[cfg(feature = "server")]
33mod server;
34
35pub use aggregate::{Aggregate, CityLabel, Forwarded, Sighting, Upstream};
36pub use answer::HistoryAnswer;
37pub use answer::HistoryRangeAnswer;
38pub use answer::PlanRow;
39pub use answer::PursuitLine;
40pub use answer::TuningDefaults;
41pub use answer::Used;
42pub use answer::VersionAuthor;
43pub use answer::{AccountStatus, EndpointSummary, EndpointsAnswer, KeyState, UnpricedCalls};
44pub use answer::{Answer, ApprovalsAnswer, ArchiveLine, BlockedLine, BuildingProgress};
45pub use answer::{ArchiveAnswer, ArchiveHit, DiscardAnswer, DiscardLine};
46pub use answer::{AutomationAnswer, Cadence, ScheduledJob, WatchedSource};
47pub use answer::{BYTES_WINDOW_MAX, BytesAnswer, DocumentVersion, ExportAnswer};
48pub use answer::{BuildingAnswer, BuildingDoc};
49pub use answer::{Call, Closing, FrozenNames, Note, Opening, Outcome, Output};
50pub use answer::{ChangesAnswer, CommitAnswer, CommitAt, CommitsAnswer, HISTORY_MAX};
51pub use answer::{ChosenSummary, CityAnswer, CostAnswer};
52pub use answer::{ConfigAnswer, ConfigLayer, ModelFactsSummary};
53pub use answer::{ContentAnswer, Drift, GitStatusAnswer, PrefixAnswer, PrefixSegment};
54pub use answer::{CostOfAnswer, EvidenceAnswer, RUN_COSTS_MAX, RunCostsAnswer};
55pub use answer::{Coverage, DocumentAnswer, DocumentBody, DocumentState, HeldDocument};
56pub use answer::{DayCount, ExportFormat, HeldSkill, McpServerUsage, McpToolUsage, McpUse};
57pub use answer::{Decision, GovernanceAnswer};
58pub use answer::{DoctorAbsence, DoctorAnswer, DoctorCore, DoctorFault, DoctorInstall, DoctorItem};
59pub use answer::{DoctorCoverage, DoctorCustody, DoctorCustodyLifetime, DoctorCustodyStore};
60pub use answer::{DoctorDrive, DoctorExclusion, DoctorScanning, DoctorUntold};
61pub use answer::{DoctorGuarantee, DoctorGuaranteeAxis, DoctorSandbox, DoctorSandboxArm};
62pub use answer::{DoctorNeed, DoctorState, DoctorTier, DoctorVerdict, DoctorVersion};
63pub use answer::{DoctorNewest, DoctorPack, DoctorUnread, DoctorUpstream};
64pub use answer::{DoctorSandboxMissing, SandboxArm};
65pub use answer::{Entry, EntryKind, ListingAnswer, PreviewAnswer, RangeAnswer};
66pub use answer::{EvidenceItem, EvidenceKind, Picture};
67pub use answer::{FIND_MAX, FIND_WALK_MAX, FindAnswer, Walked};
68pub use answer::{GithubLoginAnswer, GithubReading};
69pub use answer::{HandbackNote, ReplyEnd, ReplyEnded, Speaker};
70pub use answer::{HarnessLine, HarnessState, HarnessesAnswer};
71pub use answer::{HunksAnswer, PatchLine, Withheld};
72pub use answer::{IdentityAnswer, StatedIdentity};
73pub use answer::{InboxAnswer, MetricsAnswer, RegistryAnswer, RegistryLine, SignalLine};
74pub use answer::{InstallChannel, Registry, RegistryNewest, RegistryReading};
75pub use answer::{KnownFace, KnownHost, KnownHostsAnswer};
76pub use answer::{McpHealthAnswer, McpServerHealth, McpState, McpToolLine, McpUsageAnswer};
77pub use answer::{OfferedCard, OpenProposalsAnswer, ProposalCard, ProposalsAnswer};
78pub use answer::{PrefixSlot, PrefixSource, SkillLine, SkillShelf, SkillsAnswer};
79pub use answer::{ReleaseAnswer, ReleaseLine, UpdateHint};
80pub use answer::{RoundsAnswer, Timing, Turn};
81pub use answer::{RunSummary, Waiting};
82pub use answer::{SESSION_PREVIEW_MAX, SESSIONS_MAX, SessionLine, SessionStart, SessionsAnswer};
83pub use answer::{SecondDomain, SettledEffort, SettledSearch, SettledSecond, SupplierAccounts};
84pub use answer::{ShellCalls, ShellsAnswer, UsageExportAnswer, UsageKind, UseOutcome};
85pub use answer::{SkillAudit, SkillUsageAnswer, SkillUsageLine, SkillUse, SkillVersion};
86pub use answer::{Standing, ToolkitLine, ToolkitsAnswer};
87pub use answer::{VERSIONS_MAX, VersionSource, VersionsAnswer};
88#[cfg(feature = "server")]
89pub use assets::{AssetReply, ClientAssets, EmbeddedFile};
90pub use auth::{Pairing, PairingToken, verify};
91pub use carried_name::{ProviderName, TemplateName, ToolkitSlug};
92pub use command::COMMAND_NAMES;
93pub use command::{BodyOverride, EndpointTuning, HeaderPair};
94pub use command::{Carry, Command, WireCommand};
95pub use command::{CitySettings, GovernedDocument, HaltScope, IdentityCard, NoSecret, RulesWrite};
96pub use command::{DoorAnswer, DoorOpening, DoorStep, SecretForgetting};
97pub use command::{PolicyChange, ProposalDecision, ProposalDecisions, RangeWrite, SessionNaming};
98pub use command::{PursuitStep, Shelf, SpineDocument};
99pub use control::{ControlVerdict, Intervention, classify};
100#[cfg(feature = "schema")]
101pub use frames::wire_schema;
102pub use frames::{Answered, Ask, AskId, AskOutcome};
103pub use frames::{BEAT_MAX_MS, BEAT_MIN_MS, BeatMs};
104pub use frames::{ClientFrame, Delta, LiveOutput, OutputStream, ServerFrame};
105pub use frames::{Hello, Query, Welcome};
106pub use frames::{Lagged, LogLevel, LogLine, Monitoring, Sample, Watched};
107pub use frames::{QUERY_NAMES, WIRE_V, schema_hash};
108pub use guide::{GuideMark, GuideProgress, GuideState, GuideStep};
109pub use kernel::{FileChange, How, Lines};
110pub use preference::{Appearance, Chord, Chroma, Density, Face, Lang, Lighting, Motion};
111pub use preference::{BODY_PX_MIN, BodyPx, PreferencePatch, PreferencesAnswer};
112pub use preference::{CorePlacement, CorePreferences, CorePriority};
113pub use preference::{Glass, ReadingFace, ThemeOverride, Tier};
114pub use preference::{SessionTags, TAG_MAX, Tag};
115pub use privacy::{PrivacyAction, PrivacyOutcome, PrivacyRequest, PrivacyResult};
116pub use privacy::{PrivacyAnswer, PrivacyControlEntry, PrivacyCurrent, PrivacyEditions};
117pub use privacy::{PrivacyBuildEffect, PrivacyCategory, PrivacyEdition, PrivacyEditionFit};
118pub use privacy::{PrivacyControl, PrivacyFaultCode, PrivacyNotWritten, PrivacyOriginal};
119pub use privacy::{PrivacyHistory, PrivacyHost, PrivacyIntent, PrivacyNotWrittenEntry};
120pub use privacy::{PrivacyOriginalLine, PrivacyTarget, PrivacyValue, PrivacyWindows};
121pub use privacy::{PrivacyScope, PrivacySettlement};
122pub use reading::{OUTPUT_LINES, arguments_in, note_of, output_in, said_in};
123pub use reading::{text, thought_in, used_in};
124#[cfg(feature = "server")]
125pub use reception::{Admission, BindFace, BindVerdict, Door, HandshakeVerdict};
126#[cfg(feature = "server")]
127pub use reception::{SessionState, SessionStep, WelcomeFacts, decide_frame};
128#[cfg(feature = "server")]
129pub use reception::{decide_admission, offered_pairing};
130#[cfg(feature = "server")]
131pub use reception::{decide_bind, decide_handshake};
132pub use reply::{AcpProgress, Delivered, Reply};
133#[cfg(feature = "server")]
134pub use server::{AcpSink, Answering, MonitorFeed, TranscribeSink};
135#[cfg(feature = "server")]
136pub use server::{Bound, Committed, LedgerHead, ServeConfig};
137#[cfg(feature = "server")]
138pub use server::{DROP_BYTES_MAX, DropSink};
139#[cfg(feature = "server")]
140pub use server::{bind, bundle_routes, router, serve};
141
142pub use kernel::WriteLimit;
143pub use kernel::model::{AdmissionRequirement, LandingPolicy, Mode, RunPolicy, Window};
144pub use kernel::{Address, ApprovalId, Autonomy, AxCode, AxError, B3Hash};
145pub use kernel::{ApprovalClass, ApprovalItem, ClusterKey, Restoration};
146pub use kernel::{BudgetUse, Locator, PlannedProgress, Progress, UnplannedProgress};
147pub use kernel::{DialectKind, Effort, KeepWarm, ModelTag};
148pub use kernel::{EventDraft, EventKind, EventRecord, GitOid, IdemKey, RunId};
149pub use kernel::{McpServer, McpTransport, SandboxLimits, ServerLabel};
150pub use kernel::{NodeId, PursuitState, RoadmapStatus, WHOLE_PPB};
151pub use kernel::{Payload, Sealed, Seq, TimeMs, Tokens, UsdMicros};
152pub use kernel::{Ruling, SessionName, WriteDomain};
wire/lib.rs

wire/
lib.rs
