Compose canonical first Briefs

ace/application/__init__.py

@@ -315,6 +315,7 @@
     AuthorizedIntelligenceBuild,
     IntelligenceBuildEffect,
     IntelligenceBuildExecutor,
+    IntelligenceBuildFirstBriefPort,
     IntelligenceBuildHostServices,
     IntelligenceBuildPreparedDerivationPort,
     IntelligenceBuildRecordedSourcePort,
@@ -323,6 +324,15 @@
     ProductScopedImmutableRecordStore,
     RecordedSourceReferenceV1,
 )
+from ace.application.intelligence_build_first_brief import (
+    CREATE_FIRST_BRIEF_EFFECT,
+    INTELLIGENCE_BUILD_FIRST_BRIEF_REQUEST_VERSION,
+    CoreIntelligenceBuildFirstBriefService,
+    IntelligenceBuildFirstBriefCognition,
+    IntelligenceBuildFirstBriefError,
+    IntelligenceBuildFirstBriefOutcome,
+    IntelligenceBuildFirstBriefRequestV1Alpha1,
+)
 from ace.application.intelligence_builder import (
     ConnectionAgent,
     ConnectionAgentError,
@@ -833,6 +843,7 @@
     "IntelligenceBuilderSessionService",
     "IntelligenceBuildEffect",
     "IntelligenceBuildExecutor",
+    "IntelligenceBuildFirstBriefPort",
     "IntelligenceBuildHostServices",
     "IntelligenceBuildPreparedDerivationPort",
     "IntelligenceBuildResourcePagePort",
@@ -842,6 +853,13 @@
     "ProductScopedImmutableRecordStore",
     "CoreRecordedSourceAdmissionService",
     "CorePreparedShiftSignalDerivationService",
+    "CoreIntelligenceBuildFirstBriefService",
+    "CREATE_FIRST_BRIEF_EFFECT",
+    "INTELLIGENCE_BUILD_FIRST_BRIEF_REQUEST_VERSION",
+    "IntelligenceBuildFirstBriefCognition",
+    "IntelligenceBuildFirstBriefError",
+    "IntelligenceBuildFirstBriefOutcome",
+    "IntelligenceBuildFirstBriefRequestV1Alpha1",
     "REQUIRED_INTELLIGENCE_BUILD_EFFECTS",
     "RecordedSourceAcquisitionReceiptV1Alpha1",
     "RecordedSourceAdmission",

ace/application/intelligence_build_execution.py

@@ -29,6 +29,10 @@
 from ace.intelligence.contracts.common import validate_digest, validate_reference, validate_slug
 
 if TYPE_CHECKING:
+    from ace.application.intelligence_build_first_brief import (
+        IntelligenceBuildFirstBriefOutcome,
+        IntelligenceBuildFirstBriefRequestV1Alpha1,
+    )
     from ace.application.prepared_shift_signal import (
         PreparedShiftSignalDerivationOutcome,
         PreparedShiftSignalDerivationRequestV1Alpha1,
@@ -238,6 +242,15 @@ async def derive(
     ) -> "PreparedShiftSignalDerivationOutcome": ...
 
 
+class IntelligenceBuildFirstBriefPort(Protocol):
+    """Narrow host capability for one exact routed canonical first Brief."""
+
+    async def create_first_brief(
+        self,
+        request: "IntelligenceBuildFirstBriefRequestV1Alpha1",
+    ) -> "IntelligenceBuildFirstBriefOutcome": ...
+
+
 @dataclass(frozen=True, slots=True)
 class IntelligenceBuildHostServices:
     """Invocation-scoped capabilities Core grants to one trusted executor."""
@@ -247,6 +260,7 @@ class IntelligenceBuildHostServices:
     activation_authority: CoreAuthorityResolver
     recorded_sources: IntelligenceBuildRecordedSourcePort | None = None
     prepared_derivations: IntelligenceBuildPreparedDerivationPort | None = None
+    first_brief: IntelligenceBuildFirstBriefPort | None = None
 
 
 class IntelligenceBuildExecutor(Protocol):
@@ -262,6 +276,7 @@ async def start(
     "IntelligenceBuildEffect",
     "IntelligenceBuildExecutor",
     "IntelligenceBuildHostServices",
+    "IntelligenceBuildFirstBriefPort",
     "IntelligenceBuildPreparedDerivationPort",
     "IntelligenceBuildResourcePagePort",
     "IntelligenceBuildRecordedSourcePort",