export interface GraphenixMetadata {
    /** Optional dynamic client payload — core validates object shape only. */
    data?: Record<string, unknown>;
    [key: string]: unknown;
}
/** Graph-level metadata with first-class executable fields. */
export interface GraphMetadata extends GraphenixMetadata {
    graphEntry?: GraphEntryContract;
    graphResponse?: GraphResponseContract;
    /** Graph-wide AI model cases — validated by executable profile packages. */
    modelConfig?: Record<string, unknown>;
    name?: string;
    description?: string;
    [key: string]: unknown;
}
export interface PortDefinition {
    id: string;
    name?: string;
    direction: "input" | "output";
    type: string;
    required?: boolean;
    default?: any | null;
}
export type GraphPort = PortDefinition;
export interface EdgeEndpoint {
    nodeId: string;
    portId: string;
}
export interface Edge<TMetadata extends GraphenixMetadata = GraphenixMetadata> {
    id: string;
    from: EdgeEndpoint;
    to: EdgeEndpoint;
    metadata?: TMetadata;
}
export type GraphEdge<TMetadata extends GraphenixMetadata = GraphenixMetadata> = Edge<TMetadata>;
export interface Node<TParameters = Record<string, unknown>, TMetadata extends GraphenixMetadata = GraphenixMetadata> {
    id: string;
    name?: string;
    kind: string;
    inputs?: PortDefinition[];
    outputs?: PortDefinition[];
    parameters?: TParameters;
    metadata?: TMetadata;
    /** Design-only canvas position. Ignored by compile; see docs/DESIGN-FORMAT-GAPS.md §3.8 */
    layout?: {
        x?: number;
        y?: number;
        [key: string]: unknown;
    };
}
export type GraphNode<TParameters = Record<string, unknown>, TMetadata extends GraphenixMetadata = GraphenixMetadata> = Node<TParameters, TMetadata>;
export type GraphInputSemanticKind = "record" | "query" | "user-input" | "content" | "metadata" | "execution" | (string & {});
export interface GraphInputResolver {
    kind?: string;
    graphId?: string;
    metadataFilter?: Record<string, unknown>;
    [key: string]: unknown;
}
export interface GraphInputContract {
    semanticKind?: GraphInputSemanticKind;
    required?: boolean;
    schema?: JsonSchemaObject;
    resolver?: GraphInputResolver;
    [key: string]: unknown;
}
export type GraphOutputSemanticKind = "record" | "content" | "metadata" | "execution" | "final-output" | (string & {});
export interface GraphOutputContract {
    semanticKind?: GraphOutputSemanticKind;
    required?: boolean;
    schema?: JsonSchemaObject;
    description?: string;
    [key: string]: unknown;
}
export interface GraphInput<TMetadata extends GraphenixMetadata = GraphenixMetadata> {
    id: string;
    name?: string;
    type: string;
    target: EdgeEndpoint;
    contract?: GraphInputContract;
    metadata?: TMetadata;
}
export interface GraphOutput<TMetadata extends GraphenixMetadata = GraphenixMetadata> {
    id: string;
    name?: string;
    type: string;
    source?: EdgeEndpoint;
    contract?: GraphOutputContract;
    metadata?: TMetadata;
}
export interface Graph<TGraphMetadata extends GraphMetadata = GraphMetadata, TNodeParameters = Record<string, unknown>, TNodeMetadata extends GraphenixMetadata = GraphenixMetadata, TEdgeMetadata extends GraphenixMetadata = GraphenixMetadata> {
    nodes: Node<TNodeParameters, TNodeMetadata>[];
    edges: Edge<TEdgeMetadata>[];
    inputs: GraphInput[];
    outputs: GraphOutput[];
    /** Executable response contract (shape, persistency target). */
    response?: GraphResponseDefinition;
    metadata?: TGraphMetadata;
}
export interface TypeField {
    name: string;
    type: string;
    required?: boolean;
}
export interface TypeBase<TMetadata extends GraphenixMetadata = GraphenixMetadata> {
    id: string;
    kind: "object" | "union" | "alias";
    description?: string;
    metadata?: TMetadata;
}
export interface TypeObject<TMetadata extends GraphenixMetadata = GraphenixMetadata> extends TypeBase<TMetadata> {
    kind: "object";
    fields: TypeField[];
}
export interface TypeUnion<TMetadata extends GraphenixMetadata = GraphenixMetadata> extends TypeBase<TMetadata> {
    kind: "union";
    options: string[];
}
export interface TypeAlias<TMetadata extends GraphenixMetadata = GraphenixMetadata> extends TypeBase<TMetadata> {
    kind: "alias";
    target: string;
}
export type TypeDefinition<TMetadata extends GraphenixMetadata = GraphenixMetadata> = TypeObject<TMetadata> | TypeUnion<TMetadata> | TypeAlias<TMetadata>;
export type GraphType<TMetadata extends GraphenixMetadata = GraphenixMetadata> = TypeDefinition<TMetadata>;
export interface SubgraphDefinition<TGraphMetadata extends GraphenixMetadata = GraphenixMetadata, TNodeParameters = Record<string, unknown>, TNodeMetadata extends GraphenixMetadata = GraphenixMetadata, TEdgeMetadata extends GraphenixMetadata = GraphenixMetadata> {
    id: string;
    name?: string;
    graph: Graph<TGraphMetadata, TNodeParameters, TNodeMetadata, TEdgeMetadata>;
    metadata?: GraphenixMetadata;
}
export type Subgraph<TGraphMetadata extends GraphenixMetadata = GraphenixMetadata, TNodeParameters = Record<string, unknown>, TNodeMetadata extends GraphenixMetadata = GraphenixMetadata, TEdgeMetadata extends GraphenixMetadata = GraphenixMetadata> = SubgraphDefinition<TGraphMetadata, TNodeParameters, TNodeMetadata, TEdgeMetadata>;
export type JsonSchemaObject = Record<string, unknown>;
/** Wildcard entity id — Source must not filter by entity type. */
export declare const GRAPH_ENTRY_ENTITY_ID_ANY: "any";
/** Write result to sibling collection in the same entity set as the input record. */
export declare const GRAPH_RESPONSE_SAME_AS_INPUT: "same-as-input";
/** @deprecated CR-006 — data source selection is operator/work-factory concern, not graph JSON. */
export interface GraphEntryInputSpec {
    kind: string;
    path: string;
    required?: boolean;
    entityIds?: string[];
    inputTypes?: string[];
    narrativeTypeIds?: string[];
    scopingQuestionIds?: string[];
    name?: string;
}
export declare const GRAPH_RESPONSE_PERSISTENCY_LINK_TYPES: readonly ["oneToOne", "oneToMany", "manyToOne", "manyToMany"];
export type GraphResponsePersistencyLinkType = (typeof GRAPH_RESPONSE_PERSISTENCY_LINK_TYPES)[number];
/** FK + relation intent when result is written to a different entity than the job source. */
export interface GraphResponsePersistencyLink {
    relationKey: string;
    fkPath: string;
    type: GraphResponsePersistencyLinkType;
    targetContentType: string;
}
export interface GraphResponsePersistency {
    entityId: string | typeof GRAPH_RESPONSE_SAME_AS_INPUT;
    contentType?: string;
    /** When true (default), each run inserts a new result record. false = legacy replace (deprecated). */
    newRecord?: boolean;
    link?: GraphResponsePersistencyLink;
}
export interface GraphResponseDefinition {
    shape?: Record<string, unknown>;
    missing?: unknown;
    persistency?: GraphResponsePersistency;
}
export interface GraphEntryContract {
    summary?: string;
    requiredExecutionPaths?: unknown[];
    executionSchema?: JsonSchemaObject;
    notableExecutionPaths?: unknown[];
    [key: string]: unknown;
}
export interface GraphResponseContract {
    summary?: string;
    finalOutputSchema?: JsonSchemaObject;
    /** @deprecated Authoring-only. Canonical persistency lives on graph.response.persistency. */
    persistency?: GraphResponsePersistency;
    [key: string]: unknown;
}
export type WoroxCatalogRequest = Record<string, unknown>;
export type WoroxCatalogBinding = Record<string, unknown>;
export type WoroxCatalogRequests = WoroxCatalogRequest[] | Record<string, WoroxCatalogRequest>;
export type GraphDocumentMetadata = GraphenixMetadata & {
    graphEntry?: GraphEntryContract;
    graphResponse?: GraphResponseContract;
    catalogRequests?: WoroxCatalogRequests;
};
export interface GraphDocument<TDocumentMetadata extends GraphenixMetadata = GraphenixMetadata, TGraphMetadata extends GraphMetadata = GraphMetadata, TNodeParameters = Record<string, unknown>, TNodeMetadata extends GraphenixMetadata = GraphenixMetadata, TEdgeMetadata extends GraphenixMetadata = GraphenixMetadata> {
    formatVersion: "2.1.0";
    id: string;
    revision?: string;
    name?: string;
    description?: string;
    tags?: string[];
    graph: Graph<TGraphMetadata, TNodeParameters, TNodeMetadata, TEdgeMetadata>;
    types?: TypeDefinition[];
    subgraphs?: SubgraphDefinition<TGraphMetadata, TNodeParameters, TNodeMetadata, TEdgeMetadata>[];
    metadata?: TDocumentMetadata;
}
export declare const GRAPHENIX_FORMAT_VERSION: "2.1.0";
//# sourceMappingURL=types.d.ts.map