FAkka.Quotation.Actor 0.3.0-alpha1

FAkka.Quotation.Actor

供可信開發環境使用的小型 F# Quotation hot-load package。client 透過 Akka.Delivery 依序要求 host：

1. 使用 public key 封裝 managed DLL，host 以本機 encrypted private-key file 解密並載入。
2. 以 key 註冊或原子取代 ActorSystem -> 'Result Quotation。
3. 依 key 執行並取得 typed result。

Runtime 固定使用 Akka/Akka.Remote 1.5.70，serializer identifier 為 198。此工具不提供 sandbox；只適用於 caller、host 與載入程式碼皆可信的開發環境。

最小流程：

let envelope =
    match AssemblyEnvelope.create (AssemblyEnvelope.defaults publicKeyPath) dllBytes with
    | Ok value -> value
    | Error failure -> failwith failure.Message
let client = QuotationClient.start actorSystem (QuotationClientOptions.create "fsstl-live")

QuotationClient.submit client.Client (QuotationRequest.loadAssembly "load-1" replyPath envelope)
QuotationClient.submit client.Client (QuotationRequest.register "register-1" replyPath "strategy" <@ fun system -> createStrategy system @>)
QuotationClient.submit client.Client (QuotationRequest.execute "execute-1" replyPath "strategy")

每個 request 都會得到一個 terminal QuotationReply；worker 只接受 ConsumerController.Delivery<QuotationRequest>，不支援 direct Tell 繞過可靠傳遞。

Collectible unary generations（0.2.0-alpha2）

需要在同一 process side-by-side 載入同 simple-name implementation 時，application 可使用獨立的 local API；generic package 不知道 consumer 的 message、行情或交易型別：

let options =
    CollectibleAssemblyLoadOptions.create
        "generation-20260816-a"
        absoluteDllPath
        [| "FSharp.Core"; "Akka"; "Host.Contracts" |]

let generation =
    CollectibleAssemblyLoading.loadFromFile options
    |> Result.defaultWith (fun failure -> failwith failure.Message)

let quotation =
    QuotationPayload.deserializeInContext generation.LoadContext pickledQuotation
    |> Result.defaultWith (fun failure -> failwith failure.Message)

let registration =
    UnaryQuotationRegistry.registerInContext
        generation.LoadContext
        generation.GenerationId
        "node-a"
        quotation
        UnaryQuotationRegistry.empty
    |> Result.defaultWith (fun failure -> failwith failure.Message)

UnaryQuotationRegistry.execute "node-a" input registration.Registry
|> Result.defaultWith (fun failure -> failwith failure.Message)

let retired =
    UnaryQuotationRegistry.removeGeneration generation.GenerationId registration.Registry

CollectibleAssemblyLoading.requestUnload generation

主 DLL 先以 bytes 驗證、SHA-256 後由 memory stream 載入，因此 loader 不會持續鎖住來源 DLL；plugin-private dependencies 仍由 AssemblyDependencyResolver 從來源目錄解析。shared assembly 必須由 caller 明列，且只能解析成 default-context 已載入的同 simple-name assembly，避免 host contract 出現兩份 CLR type identity。

requestUnload 只是提出 collectible unload；application 必須先停止該 generation 建立的 ActorSystem、actor、timer，排空 in-flight call，並釋放 Expr/delegate/Type/Assembly references。是否完成可讀 LoadContextWeakReference，不得把 Unload() return 當成同步完成。