import { HsonData } from "../data/hson-data.js";
import type { LiveMapAnyOp, LiveMapAuthority, LiveMapCommit } from "../../types/livemap.types.js";
import type { LocusActionAuthorizer, LocusActionContext, LocusActionDelivery, LocusActionOrigin, LocusActionPayloads, LocusActionTerminalOutcome, LocusActions, LocusClientActionMessage, LocusClientActionResult, LocusConnectionContext, LocusMapValue, LocusReadonlyMap, LocusSchema, LocusSeq, LocusDisposer } from "../../types/locus.types.js";
import type { LocusActionDedupeStore } from "./locus.actions.js";
import type { LocusCommitCausation, LiveTraceContext } from "./locus.trace.js";
type LocusActionHandler<TMap extends LiveMapAuthority, TActions extends LocusActionPayloads> = NonNullable<Partial<LocusActions<TActions, TMap>>[keyof TActions & string]>;
export type LocusValidatedAction<TMap extends LiveMapAuthority, TActions extends LocusActionPayloads> = Readonly<{
    ok: true;
    handler: LocusActionHandler<TMap, TActions>;
    payload: HsonData | undefined;
}> | Readonly<{
    ok: false;
    code: "LOCUS_ACTION_UNKNOWN" | "LOCUS_ACTION_UNAVAILABLE" | "LOCUS_ACTION_INVALID";
    message: string;
}>;
/** Internal authority capture installed only by the owning solo Locus runtime. */
export type LocusSoloActionAuthorityInternals<TMap extends LiveMapAuthority, TActions extends LocusActionPayloads> = Readonly<{
    map: TMap;
    readonlyMap: LocusReadonlyMap<TMap>;
    actions: Partial<LocusActions<TActions, TMap>>;
    schema: LocusSchema<LocusMapValue<TMap>, TActions> | undefined;
    authorizer: LocusActionAuthorizer<TActions> | undefined;
    actionRequests: LocusActionDedupeStore;
    mutations: Readonly<{
        mutate: (mutation: (draft: TMap) => LiveMapCommit<LiveMapAnyOp>, source: "action", causation?: LocusCommitCausation) => Promise<LiveMapCommit<LiveMapAnyOp>>;
    }>;
    logicalMapId: string;
    incarnationId: string;
    mapMode: LiveMapAuthority["mode"];
    currentSeq: () => LocusSeq;
    nextSeq: () => LocusSeq;
    headRev: () => number;
    disposed: () => boolean;
    acquireActionActivity: () => LocusDisposer;
    traceStateBoundary: (trace: LiveTraceContext | undefined, parentSpanId: string | undefined, previousRev: number) => void;
}>;
export type LocusSoloExternalActionAttempt<TActions extends LocusActionPayloads, TMap extends LiveMapAuthority> = Readonly<{
    message: LocusClientActionMessage<TActions>;
    origin: Extract<LocusActionOrigin, {
        kind: "session";
    }>;
    connection?: LocusConnectionContext;
    emitEvent?: LocusActionContext<TMap>["emitEvent"];
    trace?: LiveTraceContext;
    parentSpanId?: string;
    attachmentCurrent: () => boolean;
}>;
export type LocusSoloActionAdmissionResult = Readonly<{
    response: LocusClientActionResult;
    kind: "legacy" | "rejected";
}> | Readonly<{
    response: LocusClientActionResult;
    kind: "deduped";
    delivery: Exclude<LocusActionDelivery, "rejected">;
    sourceTraceId?: string;
}>;
export declare function locus_action_public_error_code(code: "LOCUS_ACTION_UNKNOWN" | "LOCUS_ACTION_UNAVAILABLE" | "LOCUS_ACTION_INVALID"): "LOCUS_UNKNOWN_ACTION" | "LOCUS_ACTION_UNAVAILABLE" | "LOCUS_SCHEMA_INVALID_PAYLOAD";
export declare function resolve_locus_action_for_execution<TMap extends LiveMapAuthority, TActions extends LocusActionPayloads>(authority: LocusSoloActionAuthorityInternals<TMap, TActions>, message: LocusClientActionMessage<TActions>, trace?: LiveTraceContext, parentSpanId?: string): LocusValidatedAction<TMap, TActions>;
export declare function make_locus_action_response(id: string, outcome: LocusActionTerminalOutcome, requestId?: string, delivery?: LocusActionDelivery, attemptId?: string): LocusClientActionResult;
export declare function execute_locus_action_handler<TMap extends LiveMapAuthority, TActions extends LocusActionPayloads>(input: Readonly<{
    authority: Pick<LocusSoloActionAuthorityInternals<TMap, TActions>, "readonlyMap" | "mutations" | "currentSeq" | "nextSeq" | "headRev" | "traceStateBoundary">;
    message: LocusClientActionMessage<TActions>;
    handler: LocusActionHandler<TMap, TActions>;
    payload: HsonData | undefined;
    origin: LocusActionOrigin;
    emitEvent: LocusActionContext<TMap>["emitEvent"];
    trace?: LiveTraceContext;
    parentSpanId?: string;
    causation?: LocusCommitCausation;
}>): Promise<LocusActionTerminalOutcome>;
/** Authority-owned admission for one decoded solo external action attempt. */
export declare function admit_locus_solo_external_action<TMap extends LiveMapAuthority, TActions extends LocusActionPayloads>(authority: LocusSoloActionAuthorityInternals<TMap, TActions>, attempt: LocusSoloExternalActionAttempt<TActions, TMap>): Promise<LocusSoloActionAdmissionResult>;
export {};
//# sourceMappingURL=locus.action-admission.d.ts.map