Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory.
TypeScript agentaiai-agentsall-in-onecrmcrm-systememaillinearmcpmessagingnotesnotionofficerustslackslack-alternativestartupstartup-toolstypescriptworkspace
//! Ports for durable authoring and authorized scheduling selection.
use super::models::Snapshot;
use crate::domain::{
models::FormError,
ports::{CreateFormCommand, FormsService},
};
use databases::domain::models::Viewer;
use entity_access::domain::models::{EditAccessLevel, EntityAccessReceipt};
use models_forms::{FormDetail, FormId, FormLayout};
/// Forms' existing source-of-truth operations, with conditional authoring writes.
pub trait AuthoringCore: FormsService + crate::domain::sharing::FormSharingService {
/// Describe source schema and predictable managed identities before provisioning.
fn authoring_source(
&self,
source: &crate::domain::ports::CreateSource,
) -> impl Future<
Output = Result<(Vec<super::Column>, Vec<models_databases::ColumnId>), FormError>,
> + Send;
/// Publish liveness after a committed authoring write.
fn authoring_changed(
&self,
receipt: EntityAccessReceipt<EditAccessLevel>,
) -> impl Future<Output = ()> + Send;
/// Create closed/private at insertion with a fresh form identity.
fn create_private(
&self,
creator: Viewer,
command: CreateFormCommand,
id: FormId,
) -> impl Future<Output = Result<FormDetail, FormError>> + Send;
/// Read the actual durable draft, never substitute the respondent projection.
fn authoring_snapshot(
&self,
receipt: EntityAccessReceipt<EditAccessLevel>,
) -> impl Future<Output = Result<Snapshot, FormError>> + Send;
/// Merge the same granular Loro update into the live document, validating each merged candidate.
fn apply_authoring_update(
&self,
receipt: EntityAccessReceipt<EditAccessLevel>,
update: Vec<u8>,
) -> impl Future<Output = Result<Snapshot, super::AuthoringError>> + Send;
/// Validate and commit creation's initial layout at its observed version.
fn save_authoring_layout(
&self,
receipt: EntityAccessReceipt<EditAccessLevel>,
expected_revision: Vec<u8>,
layout: FormLayout,
) -> impl Future<Output = Result<Snapshot, FormError>> + Send;
}
/// Authoritative Forms workflows consumed by tools. Policy and orchestration stay here.
pub trait FormsAuthoringService: Send + Sync + 'static {
/// Validate and provision a complete closed/private form.
fn create_form(
&self,
actor: Viewer,
intent: super::Create,
) -> impl Future<Output = Result<super::MutationResult, super::AuthoringError>> + Send;
/// Read editor-only durable state or the respondent-safe projection.
fn read_form(
&self,
actor: Viewer,
intent: super::Read,
) -> impl Future<Output = Result<super::ReadResult, super::AuthoringError>> + Send;
/// Apply targeted CRDT edits while preserving unrelated concurrent changes.
fn edit_form(
&self,
actor: Viewer,
intent: super::Edit,
) -> impl Future<Output = Result<super::MutationResult, super::AuthoringError>> + Send;
/// Discover only grant-visible forms using bounded semantic filters.
fn list_forms(
&self,
actor: Viewer,
intent: super::List,
) -> impl Future<Output = Result<super::ListResult, super::AuthoringError>> + Send;
/// Owner-only settings changes with explicit grant deltas.
fn set_form_access(
&self,
actor: Viewer,
intent: super::SetAccess,
) -> impl Future<Output = Result<super::MutationResult, super::AuthoringError>> + Send;
}
/// Receipt acquisition stays behind the owning entity-access capability.
pub trait AuthoringAccess: Send + Sync + 'static {
/// Prove the minimum grant; callers do not manufacture their own receipts.
fn receipt<Level: entity_access::domain::models::RequiredPermission>(
&self,
actor: &Viewer,
entity: entity_access::domain::models::Entity,
) -> impl Future<Output = Result<EntityAccessReceipt<Level>, super::AuthoringError>> + Send;
}
/// Scheduling validates ownership and readiness of a stable existing target.
pub trait AuthoringBooking: Send + Sync + 'static {
/// Refuse missing, disabled, unauthorized or unusable booking links.
fn check_target(
&self,
actor: &Viewer,
target: &models_forms::BookingTarget,
) -> impl Future<Output = Result<(), super::AuthoringError>> + Send;
}
/// An unconfigured host refuses booking attachment before writes.
impl AuthoringBooking for () {
async fn check_target(
&self,
_actor: &Viewer,
_target: &models_forms::BookingTarget,
) -> Result<(), super::AuthoringError> {
Err(super::AuthoringError::new(
super::Code::BookingTargetUnavailable,
"booking",
"Booking target validation is unavailable on this host.",
))
}
}
/// Editing technology supplied by the AI editing worker; no persistence or policy.
pub trait AuthoringEditor: Send + Sync + 'static {
/// Produce one granular CRDT delta from an authorized snapshot and validated layout.
fn prepare_edit(
&self,
snapshot: &[u8],
layout: &FormLayout,
) -> impl Future<Output = Result<Vec<u8>, super::AuthoringError>> + Send;
}