mindgraph 0.11.0 → 0.13.0

package/dist/index.d.ts

@@ -72,6 +72,25 @@ interface MergeCandidate {
     similarity: number | null;
     /** How the candidate was found: "exact" | "fuzzy" | "semantic" | "llm". */
     method: string | null;
+    /**
+     * Normalized `truth_status` of each side (Claims), so curation UIs can
+     * warn before merging a refuted claim. Absent on servers older than the
+     * hardening batch.
+     */
+    node_a_truth_status?: string | null;
+    node_b_truth_status?: string | null;
+}
+/** A derived statement awaiting review after a load-bearing premise changed. */
+interface StaleDerivation {
+    invalidation_uid: string;
+    invalidator_uid: string;
+    invalidator_label: string;
+    node_uid: string;
+    node_label: string;
+    node_summary: string;
+    node_type: string;
+    reason: string | null;
+    invalidated_at: string | null;
 }
 /** A `/retrieve` hybrid result: the full node plus the fused RRF score. */
 interface HybridSearchResult {
@@ -99,11 +118,10 @@ interface PathStep {
     edge_type: string | null;
     depth: number;
     parent_uid: string | null;
-    /** Min-plus cost of the returned BFS path from the start node
-     * (sum of -ln(weight), weights clamped to (1e-9, 1]); cost of the path
-     * the traversal returned, not the cheapest path. 0 at the start node. */
+    /** Min-plus cost of the selected cheapest path from the start node
+     * (sum of -ln(weight), weights clamped to (1e-9, 1]). */
     path_cost?: number;
-    /** Product of edge confidences along the returned BFS path (clamped to
+    /** Product of edge confidences along the selected min-cost path (clamped to
      * (1e-9, 1]); a ranking signal, not a calibrated probability. 1 at the
      * start node. */
     path_confidence?: number;
@@ -271,6 +289,12 @@ interface DeliberationRequest {
     chosen_option_uid?: string;
     blocks_uid?: string;
     informs_uid?: string[];
+    /** ISO 8601 date when resolve-time context was available. */
+    as_of_date?: string;
+    /** Session whose retrieval context informed the resolution. */
+    session_id?: string;
+    /** Optional identifier of the decision-time retrieval trace. */
+    retrieval_trace_id?: string;
     props?: Record<string, unknown>;
     agent_id?: string;
 }
@@ -311,6 +335,8 @@ interface SessionRequest {
 }
 interface DistillRequest {
     label: string;
+    /** Defaults to "summary" for backward compatibility. */
+    output_type?: "summary" | "lesson";
     summary?: string;
     confidence?: number;
     salience?: number;
@@ -377,7 +403,7 @@ interface RetrieveRequest {
      * Retrieval action. Note: `"semantic"` requires a configured embedding
      * provider on the server; for semantic search use `retrieveContext()` instead.
      */
-    action: "text" | "semantic" | "hybrid" | "active_goals" | "open_questions" | "weak_claims" | "pending_approvals" | "unresolved_contradictions" | "preferences" | "layer" | "recent";
+    action: "text" | "semantic" | "hybrid" | "active_goals" | "open_questions" | "weak_claims" | "pending_approvals" | "unresolved_contradictions" | "stale_derivations" | "preferences" | "layer" | "recent";
     /**
      * Required for `"text"`, `"semantic"`, `"hybrid"`. Optional for
      * `"preferences"`: with a `query` you get topic-relevant preferences (the
@@ -389,6 +415,8 @@ interface RetrieveRequest {
      * reflect what the user likes.
      */
     query?: string;
+    /** Corpus Project whose member sources define the retrieval boundary. */
+    project_uid?: string;
     k?: number;
     threshold?: number;
     layer?: string;
@@ -427,7 +455,12 @@ interface TraverseRequest {
     max_depth?: number;
     direction?: "outgoing" | "incoming" | "both";
     edge_types?: string[];
+    exclude_edge_types?: string[];
     weight_threshold?: number;
+    /** Include ingestion/provenance edges excluded by default. */
+    include_provenance?: boolean;
+    /** Global distinct-node budget, including the seed (default 500). */
+    max_nodes?: number;
     /** `top_k_paths` only: number of cheapest paths to return (default 3, cap 25). */
     k?: number;
     /** `top_k_paths` only: max edges per path (default 8, cap 16). */
@@ -497,6 +530,8 @@ interface IngestChunkResponse {
 interface IngestDocumentRequest {
     content: string;
     title?: string;
+    /** Corpus Project to attach the ingested document to. */
+    project_uid?: string;
     document_type?: string;
     /** Semantic content type: "article" (default), "meeting_notes", "journal". Drives default extraction layers. */
     content_type?: string;
@@ -561,6 +596,8 @@ interface IngestSessionRequest {
 }
 interface RetrieveContextRequest {
     query: string;
+    /** Corpus Project whose member sources define the retrieval boundary. */
+    project_uid?: string;
     /** Max graph nodes to return (default 10). */
     node_limit?: number;
     /** Max wiki articles to return (default 3). Set to 0 to skip. */
@@ -571,6 +608,11 @@ interface RetrieveContextRequest {
     layer?: string;
     include_graph?: boolean;
     min_similarity?: number;
+    /** Reserve up to this many node slots for cheapest-first graph expansion.
+     * Default 0 preserves direct-only retrieval. */
+    graph_expansion_limit?: number;
+    /** Maximum graph-expansion hops (default 2). */
+    graph_max_depth?: number;
     /**
      * M3 as-of (valid time): ISO-8601 date to judge validity windows against.
      * Windowed nodes then carry `valid_at_time` instead of `currently_valid`.
@@ -666,6 +708,11 @@ interface RetrieveContextResponse {
             currently_valid?: boolean;
             /** As-of variant of `currently_valid` when the request set `valid_at`. */
             valid_at_time?: boolean;
+            /** Present when the node was added by budgeted graph expansion. */
+            retrieval_origin?: "graph_expansion";
+            retrieval_path_cost?: number;
+            retrieval_depth?: number;
+            retrieval_parent_uid?: string | null;
         })[];
         edges: Record<string, unknown>[];
     };
@@ -828,11 +875,136 @@ interface MindGraphConfig {
     apiKey?: string;
     jwt?: string;
     orgId?: string;
+    /**
+     * Non-security telemetry hint for first-party adapters. The cloud accepts
+     * only `dashboard`/`mcp`, normalizes everything else to `api`, and never
+     * uses this value for authorization or result membership.
+     */
+    telemetrySurface?: "dashboard" | "mcp";
     /** Max retries for 503 (server warming up) responses. Default: 3. Set to 0 to disable. */
     maxRetries?: number;
     /** Initial backoff in ms before first retry. Doubles each attempt. Default: 1000. */
     retryBackoffMs?: number;
 }
+/** Schema-level behavior for compiled semantic-match diagnostics. */
+type SemanticValidationMode = "off" | "advisory" | "review" | "strict";
+/** Validation modes accepted by the M5.1 schema update endpoint. */
+type SemanticValidationAuthoringMode = "off" | "advisory";
+/** The six storage/runtime behaviors supported by semantic profile v1. */
+type SemanticRuntimeTemplate = "entity" | "dependent_entity" | "collective" | "relationship_object" | "event" | "observation";
+/** Optional orthogonal classifications that do not introduce storage layouts. */
+type SemanticModifier = "role" | "phase" | "social_construct";
+type OntologicalBaseKind = "kind" | "subkind" | "dependent_particular" | "collective" | "relator" | "event" | "quality" | "unspecified";
+type SemanticRigidity = "rigid" | "anti_rigid" | "unspecified";
+type SemanticIdentityMode = "provided" | "inherited" | "derived" | "unspecified";
+type SemanticDependence = "independent" | "bearer" | "external" | "unspecified";
+type SemanticTemporalMode = "persistent" | "interval" | "occurrence" | "observation_time" | "unspecified";
+type SemanticMatchStatus = "candidate" | "accepted" | "rejected" | "superseded";
+type SemanticEvidenceSourceKind = "corpus_span" | "declared_structure" | "sql_metadata" | "graph_usage" | "human_review" | "llm_classification";
+type SemanticSignalKind = "own_identity" | "borrowed_identity" | "host_attachment" | "participant_count" | "membership_relation" | "occurs_at" | "observed_at" | "externally_assigned" | "lifecycle_stage" | "institutionally_defined" | "relation_endpoints";
+type ParticipantSlotKind = "bearer" | "player" | "context" | "subject" | "source" | "participant" | "member" | "observed_entity" | "base_type";
+/** A typed participant requirement resolved against the containing schema version. */
+interface SemanticParticipantSlot {
+    name: string;
+    template_slot: ParticipantSlotKind;
+    object_types?: string[];
+    min?: number;
+    max?: number;
+    relation_type?: string;
+}
+type FieldSemanticKind = "phase_indicator" | "role_indicator" | "internal_disposition" | "event_time" | "observed_at" | "source_wording";
+/** Typed meaning for a concrete object field; prose is never compiled. */
+interface FieldSemantic {
+    field: string;
+    semantic: FieldSemanticKind;
+    temporal_mode?: SemanticTemporalMode;
+    lossy?: boolean;
+}
+type NormativeKind = "need" | "constraint" | "obligation" | "preference" | "unspecified";
+type CanonicalAttachmentAuthority = "relation" | "reference_field";
+type CanonicalAttachmentDirection = "outgoing" | "incoming";
+/** Declares which of a relation/reference-field pair owns an attachment fact. */
+interface CanonicalAttachmentBinding {
+    slot: string;
+    relation_type: string;
+    reference_field?: string;
+    authority: CanonicalAttachmentAuthority;
+    direction: CanonicalAttachmentDirection;
+}
+/** Pins a match to one immutable global archetype template version. */
+interface SemanticTemplateRef {
+    id: string;
+    version: number;
+}
+interface SemanticEvidenceRef {
+    id: string;
+    source_kind: SemanticEvidenceSourceKind;
+    source_ref: string;
+    asserted_by?: string;
+    asserted_at?: string;
+}
+interface SemanticGeneratorRef {
+    id: string;
+    version: number;
+    proposal_ref?: string;
+}
+interface SemanticSignal {
+    signal: SemanticSignalKind;
+    value: boolean | number | string;
+    evidence_ref: SemanticEvidenceRef;
+    generator?: SemanticGeneratorRef;
+    confidence: number;
+    observed_at?: string;
+}
+interface SemanticNegativeControl {
+    template: SemanticTemplateRef;
+    reason: string;
+}
+interface SemanticMatchAlternative {
+    template: SemanticTemplateRef;
+    confidence: number;
+    reason: string;
+    evidence?: SemanticSignal[];
+}
+interface SemanticModifierMatch {
+    template: SemanticTemplateRef;
+    evidence: SemanticSignal[];
+    negative_control: SemanticNegativeControl;
+}
+interface SemanticReviewDecision {
+    actor: string;
+    decided_at: string;
+    rationale: string;
+    premises?: string[];
+    supersedes?: string;
+}
+interface SemanticTenantBindings {
+    ontological_base_kind?: OntologicalBaseKind;
+    rigidity?: SemanticRigidity;
+    identity_mode?: SemanticIdentityMode;
+    dependence?: SemanticDependence;
+    temporal_mode?: SemanticTemporalMode;
+    slots?: SemanticParticipantSlot[];
+    fields?: FieldSemantic[];
+    normative_kind?: NormativeKind;
+    attachments?: CanonicalAttachmentBinding[];
+}
+type SemanticRelationKind = "association" | "mediation" | "participation" | "membership" | "characterization" | "part_whole" | "derivation" | "classification" | "unspecified";
+/** Unified evidence-backed classification for object and relation types. */
+interface SemanticMatch {
+    version: number;
+    template: SemanticTemplateRef;
+    modifiers?: SemanticModifierMatch[];
+    status: SemanticMatchStatus;
+    evidence: SemanticSignal[];
+    negative_control: SemanticNegativeControl;
+    alternatives?: SemanticMatchAlternative[];
+    bindings?: SemanticTenantBindings;
+    confidence: number;
+    rationale: string;
+    proposed_by?: SemanticGeneratorRef[];
+    decision?: SemanticReviewDecision;
+}
 /** Field schema entry inside `OntologyObjectType.fields_json`. */
 interface FieldDefinition {
     name: string;
@@ -910,6 +1082,12 @@ interface OntologySchema {
     description?: string;
     status: "draft" | "active" | "deprecated" | "archived";
     version: number;
+    /**
+     * Advisory semantic-profile validation is opt-in per schema. Optional so the
+     * SDK tolerates servers that predate the field (the server itself defaults
+     * absent rows to "off").
+     */
+    semantic_validation_mode?: SemanticValidationMode;
     propose_status?: "pending" | "running" | "ready" | "failed" | null;
     propose_job_id?: string | null;
     propose_error?: string | null;
@@ -935,6 +1113,8 @@ interface OntologyObjectType {
     extraction_hints?: string | null;
     default_confidence: number;
     review_policy: "always" | "low_confidence" | "never";
+    /** Accepted semantic match. Candidates remain in the proposal ledger. */
+    semantic_match?: SemanticMatch | null;
     /** Datasource binding (null = extracted/authored). */
     backing?: ObjectBacking | null;
     status: "active" | "deprecated" | "archived";
@@ -957,7 +1137,10 @@ interface OntologyRelationType {
     inverse_relation_type?: string | null;
     fields_json: FieldDefinition[];
     extraction_hints?: string | null;
+    default_confidence: number;
     review_policy: "always" | "low_confidence" | "never";
+    /** Accepted relation match. Candidates remain in the proposal ledger. */
+    semantic_match?: SemanticMatch | null;
     /** Datasource binding (null = extracted/authored). */
     backing?: RelationBacking | null;
     status: "active" | "deprecated" | "archived";
@@ -975,8 +1158,10 @@ interface OntologyToolDescriptor {
     description: string;
     schema_id: string;
     object_type: string;
-    /** "search" | "object" | "object_context" */
-    maps_to: string;
+    maps_to: "search" | "object" | "object_context" | "related" | "structured_query";
+    relation?: string;
+    entry_role?: "source" | "target";
+    far_type?: string;
     input_schema: Record<string, unknown>;
 }
 interface CreateOntologySchemaRequest {
@@ -986,6 +1171,7 @@ interface CreateOntologySchemaRequest {
 interface UpdateOntologySchemaRequest {
     name?: string;
     description?: string;
+    semantic_validation_mode?: SemanticValidationAuthoringMode;
 }
 interface OntologyObjectTypeInput {
     name: string;
@@ -999,6 +1185,8 @@ interface OntologyObjectTypeInput {
     extraction_hints?: string;
     default_confidence?: number;
     review_policy?: "always" | "low_confidence" | "never";
+    /** Add, replace, or clear the object's accepted semantic match. */
+    semantic_match?: SemanticMatch | null;
     /** Bind this object type to an external source (SQL). Omit for extracted/authored. */
     backing?: ObjectBacking | null;
 }
@@ -1014,7 +1202,10 @@ interface OntologyRelationTypeInput {
     inverse_relation_type?: string;
     fields?: FieldDefinition[];
     extraction_hints?: string;
+    default_confidence?: number;
     review_policy?: "always" | "low_confidence" | "never";
+    /** Add, replace, or clear the relation's accepted semantic match. */
+    semantic_match?: SemanticMatch | null;
     /** Bind this relation to an FK column or M:M join table. Both endpoints must be sql-mapped. */
     backing?: RelationBacking | null;
 }
@@ -1025,6 +1216,8 @@ interface OntologyProposal {
     schema_id: string;
     proposal_type: string;
     proposed_by_agent_id?: string | null;
+    proposed_by_user_id?: string | null;
+    extract_job_id?: string | null;
     source_uids: string[];
     source_scope_ids: string[];
     changes_json: {
@@ -1049,6 +1242,34 @@ interface OntologyProposal {
     resolved_at?: string | null;
     resolved_by?: string | null;
 }
+interface OntologyDuplicateAudit {
+    schema_id: string;
+    object_groups: Array<{
+        object_type: string;
+        identity_hash: string;
+        canonical_uid: string;
+        members: Array<{
+            uid: string;
+            label: string;
+            source_uids: string[];
+        }>;
+        conflicting_fields: string[];
+        affected_edges: number;
+        auto_merge_safe: boolean;
+    }>;
+    relation_groups: Array<{
+        relation_type: string;
+        identity_hash: string;
+        canonical_uid: string;
+        edge_uids: string[];
+        from_uid: string;
+        to_uid: string;
+        auto_merge_safe: boolean;
+    }>;
+    objects_without_deterministic_identity: number;
+    context_ambiguous_objects: number;
+    repeatable_relations_skipped: number;
+}
 interface ProposalEdits {
     canonical_name?: string;
     fields?: Record<string, unknown>;
@@ -1071,20 +1292,125 @@ interface ProposeOntologySchemaRequest {
 interface OntologyQueryRequest {
     query: string;
     schema_id: string;
+    project_uid?: string;
     object_types?: string[];
     include_cognitive_context?: boolean;
     include_sources?: boolean;
     depth?: number;
     limit?: number;
 }
+type OntologyPredicateOperator = "eq" | "neq" | "in" | "contains" | "gte" | "lte" | "exists";
+interface OntologyQueryPredicate {
+    field: string;
+    op: OntologyPredicateOperator;
+    value?: unknown;
+}
+interface StructuredOntologyQueryRequest {
+    schema_id: string;
+    select: string;
+    project_uid?: string;
+    anchor?: {
+        type: string;
+        uid?: string;
+        match?: {
+            value: string;
+            field?: string;
+        };
+    };
+    path?: Array<{
+        relation: string;
+        entry_role: "source" | "target";
+    }>;
+    where?: OntologyQueryPredicate[];
+    include?: {
+        provenance?: boolean;
+        related?: string[];
+    };
+    page?: {
+        limit?: number;
+        offset?: number;
+    };
+    aggregate?: {
+        op: "count" | "customer_demand_rank";
+        group_by?: string;
+    };
+}
+interface StructuredOntologyQueryResponse {
+    plan: Record<string, unknown>;
+    rows: Array<{
+        object: DomainObject;
+        related?: Record<string, DomainObject[]>;
+    }>;
+    relations: Array<{
+        uid: string;
+        relation: string;
+        from_uid: string;
+        to_uid: string;
+        fields: unknown;
+        leg_index?: number;
+    }>;
+    provenance: Array<{
+        node_uid: string;
+        source_uid: string;
+        text_span: string;
+    }>;
+    aggregate?: unknown;
+    total_count: number;
+    total_count_exact: boolean;
+    returned_count: number;
+    has_more: boolean;
+    coverage_complete: boolean;
+    truncation_reasons: string[];
+    diagnostics: string[];
+    metrics: Record<string, unknown>;
+}
+interface RelatedDomainObjectsRequest {
+    schema_id: string;
+    entry_type: string;
+    uid: string;
+    relation: string;
+    entry_role: "source" | "target";
+    far_type: string;
+    where?: OntologyQueryPredicate[];
+    include_provenance?: boolean;
+    limit?: number;
+    offset?: number;
+    project_uid?: string;
+}
 interface OntologyQueryResponse {
     objects: GraphNode[];
-    relations: GraphEdge[];
-    cognitive_context: Record<string, GraphNode[]>;
+    relations: Array<{
+        edge_uid: string | null;
+        from_uid: string;
+        to_uid: string;
+        edge_type: string;
+        traversal_role: string;
+        depth: number;
+    }>;
+    cognitive_context: Record<string, Array<{
+        uid: string;
+        label: string;
+        node_type: string;
+        layer: string;
+        depth: number;
+    }>>;
     external_refs: unknown[];
     graph: {
-        nodes: GraphNode[];
-        edges: GraphEdge[];
+        nodes: Array<{
+            uid: string;
+            label: string;
+            node_type: string;
+            layer: string;
+            depth: number;
+        }>;
+        edges: Array<{
+            edge_uid: string | null;
+            from_uid: string;
+            to_uid: string;
+            edge_type: string;
+            traversal_role: string;
+            depth: number;
+        }>;
     };
     provenance: Array<{
         node_uid: string;
@@ -1094,6 +1420,9 @@ interface OntologyQueryResponse {
     confidence: {
         overall: number;
     };
+    returned_count: number;
+    has_more: boolean;
+    seed_cap_hit: boolean;
     truncated?: Record<string, boolean>;
 }
 interface LinkDomainObjectsRequest {
@@ -1132,6 +1461,7 @@ declare class MindGraph {
     private headers;
     private maxRetries;
     private retryBackoffMs;
+    private telemetrySurface?;
     constructor(config: MindGraphConfig);
     private request;
     private get;
@@ -1235,6 +1565,11 @@ declare class MindGraph {
      */
     resolveDecision(decisionUid: string, chosenOptionUid: string, opts?: {
         summary?: string;
+        props?: Record<string, unknown>;
+        informs_uid?: string[];
+        as_of_date?: string;
+        session_id?: string;
+        retrieval_trace_id?: string;
         agent_id?: string;
     }): Promise<unknown>;
     procedure(req: ProcedureRequest): Promise<unknown>;
@@ -1343,6 +1678,7 @@ declare class MindGraph {
         edge_type?: string;
     }): Promise<GraphEdge[]>;
     search(query: string, opts?: {
+        project_uid?: string;
         node_type?: string;
         layer?: string;
         limit?: number;
@@ -1356,6 +1692,7 @@ declare class MindGraph {
      * the "why retrieved" detail (server ≥ 1.2.0; older servers ignore it).
      */
     hybridSearch(query: string, opts?: {
+        project_uid?: string;
         k?: number;
         node_types?: string[];
         layer?: string;
@@ -1441,6 +1778,8 @@ declare class MindGraph {
      * merge/dismiss decision (server >= 1.3).
      */
     getMergeCandidates(): Promise<MergeCandidate[]>;
+    /** Load-bearing conclusions awaiting repair after a premise changed. */
+    getStaleDerivations(limit?: number, offset?: number): Promise<StaleDerivation[]>;
     getPendingApprovals(): Promise<GraphNode[]>;
     ingestChunk(req: IngestChunkRequest): Promise<IngestChunkResponse>;
     ingestDocument(req: IngestDocumentRequest): Promise<IngestDocumentResponse>;
@@ -1546,10 +1885,18 @@ declare class MindGraph {
     addOntologyRelationType(schemaId: string, req: OntologyRelationTypeInput): Promise<OntologyRelationType>;
     updateOntologyRelationType(schemaId: string, typeId: string, req: Partial<OntologyRelationTypeInput>): Promise<OntologyRelationType>;
     deleteOntologyRelationType(schemaId: string, typeId: string): Promise<OntologyRelationType>;
+    /** Generate inert semantic classifications for individual human review. */
+    analyzeOntologySemanticGuidance(schemaId: string): Promise<{
+        created: number;
+    }>;
+    /** Read-only exact-identity collision audit; never merges graph data. */
+    auditOntologyDuplicates(schemaId: string): Promise<OntologyDuplicateAudit>;
     listOntologyProposals(opts?: {
         status?: string;
         schema_id?: string;
         object_type?: string;
+        proposal_type?: string;
+        extract_job_id?: string;
         limit?: number;
         offset?: number;
     }): Promise<{
@@ -1585,17 +1932,26 @@ declare class MindGraph {
         }[];
     }>;
     queryOntology(req: OntologyQueryRequest): Promise<OntologyQueryResponse>;
+    queryDomainStructured(req: StructuredOntologyQueryRequest): Promise<StructuredOntologyQueryResponse>;
+    queryRelatedDomainObjects(req: RelatedDomainObjectsRequest): Promise<StructuredOntologyQueryResponse>;
     /**
-     * Read-only agent tool descriptors generated from the active ontology
-     * schema(s). Each maps to a generic `/ontology` read endpoint with
-     * `object_type` bound. Used by the MCP server to expose typed per-object
-     * tools (`search_customers`, `summarize_customer`, …).
+     * Schema-qualified read-tool descriptors generated from every active
+     * ontology. Includes per-object discovery/point/context tools,
+     * relation-and-role-specific related tools, and one structured composite.
      */
     listOntologyTools(): Promise<{
         tools: OntologyToolDescriptor[];
     }>;
-    getDomainObject(uid: string): Promise<DomainObject>;
-    getDomainObjectContext(uid: string, depth?: number): Promise<OntologyQueryResponse>;
+    getDomainObject(uid: string, binding?: {
+        schema_id: string;
+        object_type: string;
+        project_uid?: string;
+    }): Promise<DomainObject>;
+    getDomainObjectContext(uid: string, depth?: number, binding?: {
+        schema_id: string;
+        object_type: string;
+        project_uid?: string;
+    }): Promise<OntologyQueryResponse>;
     getDomainObjectHistory(uid: string): Promise<{
         versions: Array<{
             version: number;
@@ -1620,12 +1976,19 @@ declare class MindGraph {
     searchDomainObjects(query: string, opts?: {
         schema_id?: string;
         object_types?: string[];
+        filters?: OntologyQueryPredicate[];
         limit?: number;
     }): Promise<{
         items: Array<{
             object: DomainObject;
             score: number;
         }>;
+        returned_count: number;
+        has_more: boolean;
+        seed_cap_hit: boolean;
+        truncation_reasons: string[];
+        total_count: null;
+        total_count_exact: false;
     }>;
     /**
      * Per-object-type coverage stats for a schema (C2f): field fill rates
@@ -1666,4 +2029,4 @@ declare class MindGraph {
     }>;
 }
 
-export { type AnalogyCandidate, type ArgumentRequest, type ArticleResult, type BatchRequest, type BelievedBy, type CaptureRequest, type ClaimHub, type ClearResponse, type ClusterClaimSample, type ClusteredClaimHub, type CommitmentRequest, type ConceptCluster, type DecayRequest, type DeliberationRequest, type DialecticalPair, type DistillRequest, type DocumentRef, type EnrichedSearchResponse, type EntityBridge, type EntityRequest, type EpistemicCounts, type EventProps, type EvolveRequest, type ExecutionRequest, type GovernanceRequest, type GraphEdge, type GraphNode, type IngestChunkRequest, type IngestChunkResponse, type IngestDocumentRequest, type IngestDocumentResponse, type IngestSessionRequest, type InquiryRequest, type Job, type ListArticlesResponse, type MemoryConfigRequest, MindGraph, type MindGraphConfig, MindGraphError, type NationProps, type OrganizationProps, type Participant, type PathStep, type PersonProps, type PlaceProps, type PlanRequest, type ProcedureRequest, type PurgeRequest, type RankedClaimHub, type RetrieveContextRequest, type RetrieveContextResponse, type RetrieveRequest, type RiskRequest, type SearchChunk, type SearchResult, type SessionRequest, type SignalsQuery, type SignalsResponse, type SourceChunk, type StructureRequest, type SynthesisJobResponse, type TextSelector, type TheorySupportGap, type TraverseRequest };
+export { type AnalogyCandidate, type ArgumentRequest, type ArticleResult, type BatchRequest, type BelievedBy, type CanonicalAttachmentAuthority, type CanonicalAttachmentBinding, type CanonicalAttachmentDirection, type CaptureRequest, type ClaimHub, type ClearResponse, type ClusterClaimSample, type ClusteredClaimHub, type CommitmentRequest, type ConceptCluster, type CreateOntologySchemaRequest, type DecayRequest, type DeliberationRequest, type DialecticalPair, type DistillRequest, type DocumentRef, type EnrichedSearchResponse, type EntityBridge, type EntityRequest, type EpistemicCounts, type EventProps, type EvolveRequest, type ExecutionRequest, type FieldDefinition, type FieldSemantic, type FieldSemanticKind, type GovernanceRequest, type GraphEdge, type GraphNode, type IngestChunkRequest, type IngestChunkResponse, type IngestDocumentRequest, type IngestDocumentResponse, type IngestSessionRequest, type InquiryRequest, type Job, type ListArticlesResponse, type MemoryConfigRequest, MindGraph, type MindGraphConfig, MindGraphError, type NationProps, type NormativeKind, type ObjectBacking, type OntologicalBaseKind, type OntologyDuplicateAudit, type OntologyObjectType, type OntologyObjectTypeInput, type OntologyPredicateOperator, type OntologyProposal, type OntologyQueryPredicate, type OntologyRelationType, type OntologyRelationTypeInput, type OntologySchema, type OntologySchemaDetail, type OntologyToolDescriptor, type OrganizationProps, type Participant, type ParticipantSlotKind, type PathStep, type PersonProps, type PlaceProps, type PlanRequest, type ProcedureRequest, type ProposalEdits, type PurgeRequest, type RankedClaimHub, type RelatedDomainObjectsRequest, type RelationBacking, type RetrieveContextRequest, type RetrieveContextResponse, type RetrieveRequest, type RiskRequest, type SearchChunk, type SearchResult, type SemanticDependence, type SemanticEvidenceRef, type SemanticEvidenceSourceKind, type SemanticGeneratorRef, type SemanticIdentityMode, type SemanticMatch, type SemanticMatchAlternative, type SemanticMatchStatus, type SemanticModifier, type SemanticModifierMatch, type SemanticNegativeControl, type SemanticParticipantSlot, type SemanticRelationKind, type SemanticReviewDecision, type SemanticRigidity, type SemanticRuntimeTemplate, type SemanticSignal, type SemanticSignalKind, type SemanticTemplateRef, type SemanticTemporalMode, type SemanticTenantBindings, type SemanticValidationAuthoringMode, type SemanticValidationMode, type SessionRequest, type SignalsQuery, type SignalsResponse, type SourceChunk, type StructureRequest, type StructuredOntologyQueryRequest, type StructuredOntologyQueryResponse, type SynthesisJobResponse, type TextSelector, type TheorySupportGap, type TraverseRequest, type UpdateOntologySchemaRequest };