Skip to content

End-to-end flows

Target

This page describes intended behaviour or structure. No implementation is claimed unless a section is explicitly marked Current implementation or Evidence.

Each flow below names the modelled services it crosses; the per-platform workflow pages hold the detail and the adverse branches. The reference flow is the 2025 narrative of the first; the per-vertical Vision-to-Production pages apply it to each example.

1. The reference run (24 steps across the planes)

sequenceDiagram
    participant U as Requester (Studio)
    participant RC as RunControlService
    participant PE as PolicyEngineService
    participant WE as WorkflowEngineService
    participant W as AgentRuntimeWorker
    participant CB as ContextBuilderService
    participant MR as ModelRouterService
    participant TA as ToolAdapterService
    participant AP as Approval (RunControl)
    participant AS as ArtifactService
    participant D as DashboardService
    U->>RC: SubmitRun scope, Published release, limits
    RC->>PE: Decide RunAcceptance · pin policy revision
    RC->>RC: resolve snapshot · reserve budget · RunAccepted
    RC->>WE: PlanNextSteps → StepReady
    RC->>W: AttemptDispatched lease
    W->>CB: Assemble context scope before ranking
    W->>MR: Invoke profile → deployment, receipt
    W->>TA: Invoke tool class, policy, sandbox, receipt
    TA-->>AP: RequestApproval for a gated class
    AP-->>U: approval card exact version
    U->>AP: DecideApproval
    TA-->>W: result · receipt
    W->>AS: store artifacts with lineage
    W->>RC: ReportAttemptOutcome
    RC->>RC: RunCompleted · usage reconciled
    RC-)D: events → timeline projection
Hold "Alt" / "Option" to enable pan & zoom

2. Knowledge ingestion

sequenceDiagram
    participant A as Workspace admin
    participant KI as KnowledgeIngestionService
    participant RI as RepositoryIntelligenceService
    participant VM as VectorMemoryService
    participant AU as AuditService
    A->>KI: RegisterSource ACL, classification, residency
    KI->>KI: SyncSource → snapshot → chunks
    KI-)VM: ChunksPublished → index revision
    KI-)RI: repository sources → symbol, dependency, history indexes
    KI-)AU: source and classification evidence
    Note over VM: retrieval enforces scope before top-k, citations carry source revision and index version
Hold "Alt" / "Option" to enable pan & zoom

3. Memory promotion

sequenceDiagram
    participant W as AgentRuntimeWorker
    participant MP as MemoryPromotionService
    participant AM as Asset maintainer
    participant AP as Approval (publication class)
    participant FB as FeedbackService
    W->>MP: Observe run-scoped observation
    MP->>MP: candidate after reinforcement
    MP-)FB: SkillCandidateProposed
    FB->>AM: LearningProposalRaised
    AM->>MP: PromoteMemory consent recorded
    MP->>AP: approval bound to the memory version
    AP-->>MP: Approved → MemoryPromoted tenant scope, expiry
Hold "Alt" / "Option" to enable pan & zoom

4. A governed tool call

sequenceDiagram
    participant W as AgentRuntimeWorker
    participant TA as ToolAdapterService
    participant PE as PolicyEngineService
    participant SB as SecretBrokerService
    participant EC as ExecutionCapacityService
    participant MCP as McpServerRegistryService
    W->>TA: Invoke tool, args, class
    TA->>PE: Decide ToolExecution → allow | require-approval | prohibited
    TA->>EC: AcquireLease sandbox pool
    TA->>SB: Issue lease-bound credential
    TA->>MCP: ResolveTool registered, authenticated server
    TA->>TA: execute · sanitize · receipt
    TA-->>W: result or Uncertain → alert and reconciliation
Hold "Alt" / "Option" to enable pan & zoom

5. Model routing with fallback

sequenceDiagram
    participant W as AgentRuntimeWorker
    participant MR as ModelRouterService
    participant CP as ComputePoolService
    participant CU as CostUsageService
    participant Q as QualityScoreService
    W->>MR: Invoke profile, constraints, privacy class
    MR->>MR: route plan from capability evidence and residency
    MR->>CP: Place local pool for restricted data
    MR->>CU: Reserve
    MR-->>W: response · receipt deployment, tokens, cost
    MR->>MR: on failure: fallback with equivalent constraints
    Q-)MR: EvaluationCompleted → capability evidence refreshed
Hold "Alt" / "Option" to enable pan & zoom

6. Product generation, from blueprint to promotion

sequenceDiagram
    participant B as BlueprintService
    participant R as GenerationRecipeService
    participant RC as RunControlService
    participant W as Agents (engineering cluster)
    participant P as PipelineExecutionService
    participant RS as ReleaseService
    participant E as EnvironmentPromotionService
    participant PR as IaCProvisioningService
    B->>B: validate · derive context map and domain model → BlueprintPublished
    R->>R: propose module plan · validate against manifests and matrix · RecipeApproved
    R-)RC: generation run
    W->>W: scaffold in sandbox · RecordOutput provenance
    W->>P: propose-change-set → pull request · pipeline
    P-)RS: PipelineRunCompleted → ProductRelease SBOM, attestations
    RS-)E: ReleaseReady
    E->>E: gates · production approval
    E-)PR: PromotionApproved desired state
    PR-)E: ProvisioningApplied → verification → PromotionCompleted
Hold "Alt" / "Option" to enable pan & zoom

7. Fleet upgrade on a template release

sequenceDiagram
    participant AR as AgentRegistryService
    participant RO as FleetRolloutService
    participant RC as RunControlService
    participant RS as ReleaseService
    participant E as EnvironmentPromotionService
    participant S as SloService
    participant INC as FleetIncidentService
    AR-)RO: AssetReleasePublished template
    RO->>RC: re-scaffold run for each affected product
    RS-)RO: ReleaseReady evaluated
    RO->>RC: production approval for production waves
    loop waves
        RO->>E: RequestPromotion × instances
        E-)RO: PromotionCompleted
        RO->>RO: bake against guards
        S-)RO: SloBreached? → RolloutHalted
        RO-)INC: incident linked to the rollout
    end
    RO-)AR: RolloutCompleted
Hold "Alt" / "Option" to enable pan & zoom