import { type JsonValue } from "../state/json.js";
import type { ActorType, MutationActor } from "../state/mutation.js";
import { type JsonPatch } from "./json-patch.js";
import type { ComputeNodeDefinition, MaybePromise, WorkflowValueParser } from "./types.js";
export type WorkflowSettingsPermission = "read" | "add" | "remove" | "replace";
export type WorkflowSettingsPathPermissions = Partial<Record<WorkflowSettingsPermission, readonly ActorType[]>>;
export type WorkflowSettingsPathRule = {
    path: string;
    permissions: WorkflowSettingsPathPermissions;
};
export type WorkflowSettingsChangeContext<TSettings> = {
    before: TSettings;
    after: TSettings;
    actor: MutationActor;
    source: string;
    patch: JsonPatch;
};
export type WorkflowSettingsDefinition<TSettings = JsonValue, TInput = unknown> = {
    initial: TSettings | ((input: TInput) => MaybePromise<TSettings>);
    parse: WorkflowValueParser<TSettings>;
    paths: readonly WorkflowSettingsPathRule[];
    description?: string;
    validateChange?: (context: WorkflowSettingsChangeContext<TSettings>) => MaybePromise<void>;
};
export type WorkflowSettingsOptions<TSettings, TInput = unknown> = {
    initial: TSettings | ((input: TInput) => MaybePromise<TSettings>);
    parse: WorkflowValueParser<TSettings>;
    paths: readonly WorkflowSettingsPathRule[];
    description?: string;
    validateChange?: (context: WorkflowSettingsChangeContext<TSettings>) => MaybePromise<void>;
};
export type AppliedWorkflowSettings<TSettings> = {
    patch: JsonPatch;
    settings: TSettings;
    json: JsonValue;
};
export type InitialWorkflowSettingsScope = {
    mountPath: string;
    invocation: number;
    settings: JsonValue;
};
export type WorkflowSettingsScopeRecord = {
    scopeId: string;
    originRunId: string;
    activeRunId: string;
    mountPath: string;
    invocation: number;
    changeNumber: number;
    settings: JsonValue;
    settingsHash: string;
    createdAt: string;
    updatedAt: string;
};
export type WorkflowSettingsChangeRequest = {
    runId: string;
    scopeId: string;
    requestId: string;
    expectedChangeNumber?: number;
    actor: MutationActor;
    source: string;
    patch: unknown;
};
export type WorkflowSettingsChangeRecord = {
    changeId: string;
    scopeId: string;
    requestId: string;
    changeNumber: number;
    actor: MutationActor;
    source: string;
    patch: JsonPatch;
    beforeHash: string;
    afterHash: string;
    acceptedAt: string;
};
export type WorkflowSettingsChangeResult = {
    scope: WorkflowSettingsScopeRecord;
    change: WorkflowSettingsChangeRecord;
    adopted: boolean;
};
export type WorkflowFollowUpState = "queued" | "removed" | "cancelled";
export type WorkflowFollowUpRecord = {
    followUpId: string;
    runId: string;
    requestId: string;
    order: number;
    targetSessionId: string;
    actor: MutationActor;
    source: string;
    prompt: string;
    state: WorkflowFollowUpState;
    reason?: string;
    createdAt: string;
    updatedAt: string;
};
export type WorkflowFollowUpQueueRecord = {
    runId: string;
    originSessionId?: string;
    followUps: WorkflowFollowUpRecord[];
};
export type WorkflowQueueFollowUpRequest = {
    runId: string;
    requestId: string;
    targetSessionId: string;
    actor: MutationActor;
    source: string;
    prompt: string;
};
export type WorkflowRemoveFollowUpRequest = {
    runId: string;
    followUpId: string;
    actor: MutationActor;
    source: string;
};
export declare function workflowSettingsScopeId(originRunId: string, mountPath: string, invocation: number): string;
export declare function workflowSettings<TSettings, TInput = unknown>(options: WorkflowSettingsOptions<TSettings, TInput>): WorkflowSettingsDefinition<TSettings, TInput>;
export declare function allowSettingsPath(path: string, permissions: WorkflowSettingsPathPermissions): WorkflowSettingsPathRule;
export declare function settingsRoute(definition: Omit<ComputeNodeDefinition, "nodeType" | "settingsRoute">): ComputeNodeDefinition;
export declare function resolveInitialWorkflowSettings<TSettings, TInput>(definition: WorkflowSettingsDefinition<TSettings, TInput>, input: TInput): Promise<AppliedWorkflowSettings<TSettings>>;
export declare function parseWorkflowSettingsValue<TSettings, TInput = unknown>(definition: WorkflowSettingsDefinition<TSettings, TInput>, raw: unknown): Promise<AppliedWorkflowSettings<TSettings>>;
export declare function applyWorkflowSettingsPatch<TSettings, TInput = unknown>(definition: WorkflowSettingsDefinition<TSettings, TInput>, before: JsonValue, patchValue: unknown, actor: MutationActor, source: string): Promise<AppliedWorkflowSettings<TSettings>>;
export declare function settingsRuleForPath(rules: readonly WorkflowSettingsPathRule[], pointer: string): WorkflowSettingsPathRule | undefined;