mindgraph 0.16.0 → 0.17.0

package/dist/index.d.mts

@@ -779,7 +779,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" | "stale_derivations" | "preferences" | "layer" | "recent";
+    action: "text" | "semantic" | "hybrid" | "active_goals" | "open_questions" | "weak_claims" | "pending_approvals" | "unresolved_contradictions" | "merge_candidates" | "stale_derivations" | "curation_counts" | "preferences" | "layer" | "recent";
     /**
      * Required for `"text"`, `"semantic"`, `"hybrid"`. Optional for
      * `"preferences"`: with a `query` you get topic-relevant preferences (the
@@ -823,6 +823,13 @@ interface RetrieveRequest {
      * provenance for citing "which teammate's notes" (D3). Requires server ≥ 1.8.0.
      */
     include_sources?: boolean;
+    /** Re-admit operational ledger and work-state nodes, excluded by default. */
+    include_ledger?: boolean;
+    /**
+     * Post-filter on how the node was created: `"document"`, `"session"` or
+     * `"agent"`.
+     */
+    source?: "document" | "session" | "agent";
 }
 interface TraverseRequest {
     action: "chain" | "neighborhood" | "path" | "subgraph" | "top_k_paths";
@@ -994,6 +1001,81 @@ interface RetrieveContextRequest {
      * Windowed nodes then carry `valid_at_time` instead of `currently_valid`.
      */
     valid_at?: string;
+    /**
+     * Point-in-time perspective: answer with what had been **stated** by this
+     * ISO-8601 date. A node is admitted when at least one of its source
+     * documents was stated (`occurred_at`, else `publication_date`) on or
+     * before the date; its own fact dates never exclude it (a plan stated in
+     * June about next year is admitted). Nodes stated on both sides of the
+     * date keep only their earlier sources and withhold the merged summary
+     * (`spans_as_of`); undated nodes stay; closed claims stay (annotated
+     * `valid_at_time: false`). Also sets the validity-annotation reference
+     * when `valid_at` is absent. Wiki articles are skipped under a
+     * time-scoped read. The response's `time_filter.axis` is
+     * `statement_time`; use `occurred_from` / `occurred_to` for a fact-time
+     * window. (Server 1.14+: before, `as_of` filtered on fact time.)
+     */
+    as_of?: string;
+    /**
+     * Inclusive occurrence window (ISO-8601, imprecision ok): only nodes and
+     * chunks whose effective interval overlaps it are returned. Undated nodes
+     * are excluded under a window. Either bound may be omitted.
+     */
+    /**
+     * Evidence plan R2 (server 1.14+): `"text"` adds `context_text`,
+     * `used_tokens`, `truncated` and `omitted` — the canonical rendering every
+     * door shares (dated items, supersession and conflict markers, a hard
+     * budget). Default `"json"`.
+     */
+    format?: "json" | "text";
+    /** Token budget for `format: "text"` (minimum 256; default 8000). */
+    max_tokens?: number;
+    /** Order of `graph.nodes` in the JSON: `"rank"` (default) or `"chronological"`. */
+    sort?: "rank" | "chronological";
+    /**
+     * `"exhaustive"` widens retrieval for list/count questions; omitted lets
+     * the server's enumeration cue decide.
+     */
+    retrieval_mode?: "normal" | "exhaustive";
+    occurred_from?: string;
+    occurred_to?: string;
+    /**
+     * Re-admit operational ledger and work-state nodes (sessions, executions,
+     * tasks, plans). Excluded from knowledge retrieval by default.
+     */
+    include_ledger?: boolean;
+    /**
+     * Bound each article's `content` to this many characters by query-aware
+     * excerpting (default 6000; 0 = unlimited). The response flags `excerpted`.
+     */
+    article_char_limit?: number;
+    /** Cosine floor for admitted articles (default 0 = off). */
+    article_min_similarity?: number;
+    /**
+     * Attach per-leg hybrid contributions (`retrieval_legs`) to direct nodes.
+     * Honored only for unscoped callers.
+     */
+    explain?: boolean;
+    /**
+     * Ontology leg control: `mode` `"auto"` (default) or `"off"`, optionally
+     * restricted to one active schema. The leg runs only when the server has it
+     * enabled and the org has an active schema.
+     */
+    ontology?: {
+        mode?: "auto" | "off";
+        schema_id?: string;
+    };
+    /**
+     * What the caller is doing right now (an agent's task, the last turns of a
+     * conversation), at most 2,000 characters. Read only by the question-aware
+     * reranker; never used as a search term and never stored.
+     */
+    intent?: string;
+    /**
+     * Apply the question-aware rerank to graph-expansion candidates. Omitted
+     * uses the server default (off).
+     */
+    rerank?: boolean;
 }
 interface ArticleResult {
     uid: string;
@@ -1075,6 +1157,39 @@ interface SeriesContextAnnotation {
     };
 }
 interface RetrieveContextResponse {
+    /**
+     * Present only when the request set `as_of`, `occurred_from` or
+     * `occurred_to`: the echoed filter plus what it excluded. World time only.
+     */
+    time_filter?: {
+        as_of?: string;
+        occurred_from?: string;
+        occurred_to?: string;
+        nodes_excluded: number;
+        chunks_excluded: number;
+        articles_excluded: boolean;
+        /** `statement_time` under `as_of` (server 1.14+), `world_time` under a window. */
+        axis: "world_time" | "statement_time";
+        /** Nodes short of `node_limit` after admission (server 1.14+). */
+        backfill_shortfall?: number;
+    };
+    /** The "now" anchor: `as_of` when given, else the request date (server 1.14+). */
+    now?: string;
+    /** Unresolved contradiction pairs among the returned nodes (server 1.14+). */
+    conflicts?: Array<Record<string, unknown>>;
+    retrieval_mode?: "exhaustive";
+    retrieval_mode_source?: "request" | "cue";
+    /** Present with `format: "text"`. */
+    context_text?: string;
+    used_tokens?: number;
+    truncated?: boolean;
+    omitted?: {
+        nodes: number;
+        chunks: number;
+        articles: number;
+        conflicts: number;
+        injections?: number;
+    };
     articles?: ArticleResult[];
     chunks?: {
         chunk_uid: string;
@@ -1093,6 +1208,10 @@ interface RetrieveContextResponse {
                 ingested_by?: string;
                 /** Display name (else email) of the ingesting teammate. */
                 ingested_by_name?: string;
+                /** When the source conversation or document occurred (ISO-8601). */
+                occurred_at?: string;
+                /** Publication date of the source document (ISO-8601). */
+                publication_date?: string;
             }[];
             source_chunks?: SourceChunk[];
             believed_by?: BelievedBy[];
@@ -1118,10 +1237,17 @@ interface RetrieveContextResponse {
         edges: Record<string, unknown>[];
     };
 }
+/** Safe terminal reason. This does not authorize replaying a whole job. */
+interface JobErrorDetails {
+    code: string;
+    message: string;
+    status: number;
+    retriable: boolean;
+}
 interface Job {
     id: string;
     title: string;
-    status: "pending" | "processing" | "completed" | "failed" | "cancelled";
+    status: "pending" | "processing" | "completed" | "completed_with_errors" | "failed" | "cancelled";
     progress: {
         total_chunks: number;
         processed_chunks: number;
@@ -1130,6 +1256,8 @@ interface Job {
     };
     result: Record<string, unknown> | null;
     error: string | null;
+    /** Absent for older servers or ordinary failures. */
+    error_details?: JobErrorDetails | null;
     created_at: number;
     queue_position?: number;
 }
@@ -1537,6 +1665,8 @@ interface OntologySchema {
     propose_status?: "pending" | "running" | "ready" | "failed" | null;
     propose_job_id?: string | null;
     propose_error?: string | null;
+    /** Durable terminal reason; absent on older servers. Review partial drafts before retry. */
+    propose_error_details?: OntologyProposeErrorDetails | null;
     created_by?: string | null;
     updated_by?: string | null;
     created_at: string;
@@ -1679,7 +1809,11 @@ interface OntologyProposal {
     approval_uid?: string | null;
     proposed_node_uid?: string | null;
     applied_job_id?: string | null;
+    /** Known result UID, including a partial result that needs reconciliation. */
+    applied_uid?: string | null;
     applied_error?: string | null;
+    /** A terminal execution failure; earlier graph changes may have committed. */
+    applied_error_details?: OntologyApplyErrorDetails | null;
     apply_attempt_count: number;
     edited_by?: string | null;
     edited_at?: string | null;
@@ -1689,6 +1823,14 @@ interface OntologyProposal {
     resolved_at?: string | null;
     resolved_by?: string | null;
 }
+/** Proposal and apply failures share the safe terminal execution metadata. */
+type OntologyProposeErrorDetails = OntologyApplyErrorDetails;
+interface OntologyApplyErrorDetails {
+    code: string;
+    message: string;
+    status: number;
+    retriable: false;
+}
 interface OntologyDuplicateAudit {
     schema_id: string;
     object_groups: Array<{
@@ -2591,4 +2733,4 @@ declare class MindGraph {
     }>;
 }
 
-export { type AggregatePoint, type AnalogyCandidate, type AppendSeriesResponse, type ArgumentRequest, type ArticleResult, type BatchAggregateSeriesResponse, type BatchLatestSeriesResponse, 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 CreateDomainObjectRequest, type CreateOntologySchemaRequest, type CreateSeriesResponse, type DecayRequest, type DeleteSeriesResponse, type DeliberationRequest, type DialecticalPair, type DistillRequest, type DocumentRef, type DomainObject, type DomainObjectMutationResponse, type EnrichedSearchResponse, type EntityBridge, type EntityRequest, type EpistemicCounts, type EventProps, type EvolveRequest, type ExecutionRequest, type FieldDefinition, type FieldSemantic, type FieldSemanticKind, type FiscalYearEnd, type ForgetOptions, type ForgetRequest, type ForgetResponse, type ForgetTarget, type GovernanceRequest, type GovernanceTarget, type GraphEdge, type GraphNode, type IngestChunkRequest, type IngestChunkResponse, type IngestDocumentRequest, type IngestDocumentResponse, type IngestSessionRequest, type InquiryRequest, type Job, type ListArticlesResponse, type ListSeriesResponse, type MeasurementPoint, type MemoryConfigRequest, type MemorySyncRequest, 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 OntologySeriesBinding, 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 RememberOptions, type RememberRequest, type RememberResponse, 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 SeriesAggregateResponse, type SeriesBacking, type SeriesContextAnnotation, type SeriesLatestResponse, type SeriesNode, type SeriesProps, type SeriesRequest, type SeriesWindowResponse, type SessionRequest, type SignalsQuery, type SignalsResponse, type SkillDistillProps, type SkillDistillRequest, type SourceChunk, type StructureRequest, type StructuredOntologyQueryRequest, type StructuredOntologyQueryResponse, type SynthesisJobResponse, type TextSelector, type TheorySupportGap, type TraverseRequest, type UpdateDomainObjectRequest, type UpdateOntologySchemaRequest };
+export { type AggregatePoint, type AnalogyCandidate, type AppendSeriesResponse, type ArgumentRequest, type ArticleResult, type BatchAggregateSeriesResponse, type BatchLatestSeriesResponse, 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 CreateDomainObjectRequest, type CreateOntologySchemaRequest, type CreateSeriesResponse, type DecayRequest, type DeleteSeriesResponse, type DeliberationRequest, type DialecticalPair, type DistillRequest, type DocumentRef, type DomainObject, type DomainObjectMutationResponse, type EnrichedSearchResponse, type EntityBridge, type EntityRequest, type EpistemicCounts, type EventProps, type EvolveRequest, type ExecutionRequest, type FieldDefinition, type FieldSemantic, type FieldSemanticKind, type FiscalYearEnd, type ForgetOptions, type ForgetRequest, type ForgetResponse, type ForgetTarget, type GovernanceRequest, type GovernanceTarget, type GraphEdge, type GraphNode, type IngestChunkRequest, type IngestChunkResponse, type IngestDocumentRequest, type IngestDocumentResponse, type IngestSessionRequest, type InquiryRequest, type Job, type ListArticlesResponse, type ListSeriesResponse, type MeasurementPoint, type MemoryConfigRequest, type MemorySyncRequest, MindGraph, type MindGraphConfig, MindGraphError, type NationProps, type NormativeKind, type ObjectBacking, type OntologicalBaseKind, type OntologyApplyErrorDetails, type OntologyDuplicateAudit, type OntologyObjectType, type OntologyObjectTypeInput, type OntologyPredicateOperator, type OntologyProposal, type OntologyProposeErrorDetails, type OntologyQueryPredicate, type OntologyRelationType, type OntologyRelationTypeInput, type OntologySchema, type OntologySchemaDetail, type OntologySeriesBinding, 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 RememberOptions, type RememberRequest, type RememberResponse, 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 SeriesAggregateResponse, type SeriesBacking, type SeriesContextAnnotation, type SeriesLatestResponse, type SeriesNode, type SeriesProps, type SeriesRequest, type SeriesWindowResponse, type SessionRequest, type SignalsQuery, type SignalsResponse, type SkillDistillProps, type SkillDistillRequest, type SourceChunk, type StructureRequest, type StructuredOntologyQueryRequest, type StructuredOntologyQueryResponse, type SynthesisJobResponse, type TextSelector, type TheorySupportGap, type TraverseRequest, type UpdateDomainObjectRequest, type UpdateOntologySchemaRequest };

package/dist/index.d.ts

@@ -779,7 +779,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" | "stale_derivations" | "preferences" | "layer" | "recent";
+    action: "text" | "semantic" | "hybrid" | "active_goals" | "open_questions" | "weak_claims" | "pending_approvals" | "unresolved_contradictions" | "merge_candidates" | "stale_derivations" | "curation_counts" | "preferences" | "layer" | "recent";
     /**
      * Required for `"text"`, `"semantic"`, `"hybrid"`. Optional for
      * `"preferences"`: with a `query` you get topic-relevant preferences (the
@@ -823,6 +823,13 @@ interface RetrieveRequest {
      * provenance for citing "which teammate's notes" (D3). Requires server ≥ 1.8.0.
      */
     include_sources?: boolean;
+    /** Re-admit operational ledger and work-state nodes, excluded by default. */
+    include_ledger?: boolean;
+    /**
+     * Post-filter on how the node was created: `"document"`, `"session"` or
+     * `"agent"`.
+     */
+    source?: "document" | "session" | "agent";
 }
 interface TraverseRequest {
     action: "chain" | "neighborhood" | "path" | "subgraph" | "top_k_paths";
@@ -994,6 +1001,81 @@ interface RetrieveContextRequest {
      * Windowed nodes then carry `valid_at_time` instead of `currently_valid`.
      */
     valid_at?: string;
+    /**
+     * Point-in-time perspective: answer with what had been **stated** by this
+     * ISO-8601 date. A node is admitted when at least one of its source
+     * documents was stated (`occurred_at`, else `publication_date`) on or
+     * before the date; its own fact dates never exclude it (a plan stated in
+     * June about next year is admitted). Nodes stated on both sides of the
+     * date keep only their earlier sources and withhold the merged summary
+     * (`spans_as_of`); undated nodes stay; closed claims stay (annotated
+     * `valid_at_time: false`). Also sets the validity-annotation reference
+     * when `valid_at` is absent. Wiki articles are skipped under a
+     * time-scoped read. The response's `time_filter.axis` is
+     * `statement_time`; use `occurred_from` / `occurred_to` for a fact-time
+     * window. (Server 1.14+: before, `as_of` filtered on fact time.)
+     */
+    as_of?: string;
+    /**
+     * Inclusive occurrence window (ISO-8601, imprecision ok): only nodes and
+     * chunks whose effective interval overlaps it are returned. Undated nodes
+     * are excluded under a window. Either bound may be omitted.
+     */
+    /**
+     * Evidence plan R2 (server 1.14+): `"text"` adds `context_text`,
+     * `used_tokens`, `truncated` and `omitted` — the canonical rendering every
+     * door shares (dated items, supersession and conflict markers, a hard
+     * budget). Default `"json"`.
+     */
+    format?: "json" | "text";
+    /** Token budget for `format: "text"` (minimum 256; default 8000). */
+    max_tokens?: number;
+    /** Order of `graph.nodes` in the JSON: `"rank"` (default) or `"chronological"`. */
+    sort?: "rank" | "chronological";
+    /**
+     * `"exhaustive"` widens retrieval for list/count questions; omitted lets
+     * the server's enumeration cue decide.
+     */
+    retrieval_mode?: "normal" | "exhaustive";
+    occurred_from?: string;
+    occurred_to?: string;
+    /**
+     * Re-admit operational ledger and work-state nodes (sessions, executions,
+     * tasks, plans). Excluded from knowledge retrieval by default.
+     */
+    include_ledger?: boolean;
+    /**
+     * Bound each article's `content` to this many characters by query-aware
+     * excerpting (default 6000; 0 = unlimited). The response flags `excerpted`.
+     */
+    article_char_limit?: number;
+    /** Cosine floor for admitted articles (default 0 = off). */
+    article_min_similarity?: number;
+    /**
+     * Attach per-leg hybrid contributions (`retrieval_legs`) to direct nodes.
+     * Honored only for unscoped callers.
+     */
+    explain?: boolean;
+    /**
+     * Ontology leg control: `mode` `"auto"` (default) or `"off"`, optionally
+     * restricted to one active schema. The leg runs only when the server has it
+     * enabled and the org has an active schema.
+     */
+    ontology?: {
+        mode?: "auto" | "off";
+        schema_id?: string;
+    };
+    /**
+     * What the caller is doing right now (an agent's task, the last turns of a
+     * conversation), at most 2,000 characters. Read only by the question-aware
+     * reranker; never used as a search term and never stored.
+     */
+    intent?: string;
+    /**
+     * Apply the question-aware rerank to graph-expansion candidates. Omitted
+     * uses the server default (off).
+     */
+    rerank?: boolean;
 }
 interface ArticleResult {
     uid: string;
@@ -1075,6 +1157,39 @@ interface SeriesContextAnnotation {
     };
 }
 interface RetrieveContextResponse {
+    /**
+     * Present only when the request set `as_of`, `occurred_from` or
+     * `occurred_to`: the echoed filter plus what it excluded. World time only.
+     */
+    time_filter?: {
+        as_of?: string;
+        occurred_from?: string;
+        occurred_to?: string;
+        nodes_excluded: number;
+        chunks_excluded: number;
+        articles_excluded: boolean;
+        /** `statement_time` under `as_of` (server 1.14+), `world_time` under a window. */
+        axis: "world_time" | "statement_time";
+        /** Nodes short of `node_limit` after admission (server 1.14+). */
+        backfill_shortfall?: number;
+    };
+    /** The "now" anchor: `as_of` when given, else the request date (server 1.14+). */
+    now?: string;
+    /** Unresolved contradiction pairs among the returned nodes (server 1.14+). */
+    conflicts?: Array<Record<string, unknown>>;
+    retrieval_mode?: "exhaustive";
+    retrieval_mode_source?: "request" | "cue";
+    /** Present with `format: "text"`. */
+    context_text?: string;
+    used_tokens?: number;
+    truncated?: boolean;
+    omitted?: {
+        nodes: number;
+        chunks: number;
+        articles: number;
+        conflicts: number;
+        injections?: number;
+    };
     articles?: ArticleResult[];
     chunks?: {
         chunk_uid: string;
@@ -1093,6 +1208,10 @@ interface RetrieveContextResponse {
                 ingested_by?: string;
                 /** Display name (else email) of the ingesting teammate. */
                 ingested_by_name?: string;
+                /** When the source conversation or document occurred (ISO-8601). */
+                occurred_at?: string;
+                /** Publication date of the source document (ISO-8601). */
+                publication_date?: string;
             }[];
             source_chunks?: SourceChunk[];
             believed_by?: BelievedBy[];
@@ -1118,10 +1237,17 @@ interface RetrieveContextResponse {
         edges: Record<string, unknown>[];
     };
 }
+/** Safe terminal reason. This does not authorize replaying a whole job. */
+interface JobErrorDetails {
+    code: string;
+    message: string;
+    status: number;
+    retriable: boolean;
+}
 interface Job {
     id: string;
     title: string;
-    status: "pending" | "processing" | "completed" | "failed" | "cancelled";
+    status: "pending" | "processing" | "completed" | "completed_with_errors" | "failed" | "cancelled";
     progress: {
         total_chunks: number;
         processed_chunks: number;
@@ -1130,6 +1256,8 @@ interface Job {
     };
     result: Record<string, unknown> | null;
     error: string | null;
+    /** Absent for older servers or ordinary failures. */
+    error_details?: JobErrorDetails | null;
     created_at: number;
     queue_position?: number;
 }
@@ -1537,6 +1665,8 @@ interface OntologySchema {
     propose_status?: "pending" | "running" | "ready" | "failed" | null;
     propose_job_id?: string | null;
     propose_error?: string | null;
+    /** Durable terminal reason; absent on older servers. Review partial drafts before retry. */
+    propose_error_details?: OntologyProposeErrorDetails | null;
     created_by?: string | null;
     updated_by?: string | null;
     created_at: string;
@@ -1679,7 +1809,11 @@ interface OntologyProposal {
     approval_uid?: string | null;
     proposed_node_uid?: string | null;
     applied_job_id?: string | null;
+    /** Known result UID, including a partial result that needs reconciliation. */
+    applied_uid?: string | null;
     applied_error?: string | null;
+    /** A terminal execution failure; earlier graph changes may have committed. */
+    applied_error_details?: OntologyApplyErrorDetails | null;
     apply_attempt_count: number;
     edited_by?: string | null;
     edited_at?: string | null;
@@ -1689,6 +1823,14 @@ interface OntologyProposal {
     resolved_at?: string | null;
     resolved_by?: string | null;
 }
+/** Proposal and apply failures share the safe terminal execution metadata. */
+type OntologyProposeErrorDetails = OntologyApplyErrorDetails;
+interface OntologyApplyErrorDetails {
+    code: string;
+    message: string;
+    status: number;
+    retriable: false;
+}
 interface OntologyDuplicateAudit {
     schema_id: string;
     object_groups: Array<{
@@ -2591,4 +2733,4 @@ declare class MindGraph {
     }>;
 }
 
-export { type AggregatePoint, type AnalogyCandidate, type AppendSeriesResponse, type ArgumentRequest, type ArticleResult, type BatchAggregateSeriesResponse, type BatchLatestSeriesResponse, 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 CreateDomainObjectRequest, type CreateOntologySchemaRequest, type CreateSeriesResponse, type DecayRequest, type DeleteSeriesResponse, type DeliberationRequest, type DialecticalPair, type DistillRequest, type DocumentRef, type DomainObject, type DomainObjectMutationResponse, type EnrichedSearchResponse, type EntityBridge, type EntityRequest, type EpistemicCounts, type EventProps, type EvolveRequest, type ExecutionRequest, type FieldDefinition, type FieldSemantic, type FieldSemanticKind, type FiscalYearEnd, type ForgetOptions, type ForgetRequest, type ForgetResponse, type ForgetTarget, type GovernanceRequest, type GovernanceTarget, type GraphEdge, type GraphNode, type IngestChunkRequest, type IngestChunkResponse, type IngestDocumentRequest, type IngestDocumentResponse, type IngestSessionRequest, type InquiryRequest, type Job, type ListArticlesResponse, type ListSeriesResponse, type MeasurementPoint, type MemoryConfigRequest, type MemorySyncRequest, 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 OntologySeriesBinding, 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 RememberOptions, type RememberRequest, type RememberResponse, 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 SeriesAggregateResponse, type SeriesBacking, type SeriesContextAnnotation, type SeriesLatestResponse, type SeriesNode, type SeriesProps, type SeriesRequest, type SeriesWindowResponse, type SessionRequest, type SignalsQuery, type SignalsResponse, type SkillDistillProps, type SkillDistillRequest, type SourceChunk, type StructureRequest, type StructuredOntologyQueryRequest, type StructuredOntologyQueryResponse, type SynthesisJobResponse, type TextSelector, type TheorySupportGap, type TraverseRequest, type UpdateDomainObjectRequest, type UpdateOntologySchemaRequest };
+export { type AggregatePoint, type AnalogyCandidate, type AppendSeriesResponse, type ArgumentRequest, type ArticleResult, type BatchAggregateSeriesResponse, type BatchLatestSeriesResponse, 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 CreateDomainObjectRequest, type CreateOntologySchemaRequest, type CreateSeriesResponse, type DecayRequest, type DeleteSeriesResponse, type DeliberationRequest, type DialecticalPair, type DistillRequest, type DocumentRef, type DomainObject, type DomainObjectMutationResponse, type EnrichedSearchResponse, type EntityBridge, type EntityRequest, type EpistemicCounts, type EventProps, type EvolveRequest, type ExecutionRequest, type FieldDefinition, type FieldSemantic, type FieldSemanticKind, type FiscalYearEnd, type ForgetOptions, type ForgetRequest, type ForgetResponse, type ForgetTarget, type GovernanceRequest, type GovernanceTarget, type GraphEdge, type GraphNode, type IngestChunkRequest, type IngestChunkResponse, type IngestDocumentRequest, type IngestDocumentResponse, type IngestSessionRequest, type InquiryRequest, type Job, type ListArticlesResponse, type ListSeriesResponse, type MeasurementPoint, type MemoryConfigRequest, type MemorySyncRequest, MindGraph, type MindGraphConfig, MindGraphError, type NationProps, type NormativeKind, type ObjectBacking, type OntologicalBaseKind, type OntologyApplyErrorDetails, type OntologyDuplicateAudit, type OntologyObjectType, type OntologyObjectTypeInput, type OntologyPredicateOperator, type OntologyProposal, type OntologyProposeErrorDetails, type OntologyQueryPredicate, type OntologyRelationType, type OntologyRelationTypeInput, type OntologySchema, type OntologySchemaDetail, type OntologySeriesBinding, 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 RememberOptions, type RememberRequest, type RememberResponse, 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 SeriesAggregateResponse, type SeriesBacking, type SeriesContextAnnotation, type SeriesLatestResponse, type SeriesNode, type SeriesProps, type SeriesRequest, type SeriesWindowResponse, type SessionRequest, type SignalsQuery, type SignalsResponse, type SkillDistillProps, type SkillDistillRequest, type SourceChunk, type StructureRequest, type StructuredOntologyQueryRequest, type StructuredOntologyQueryResponse, type SynthesisJobResponse, type TextSelector, type TheorySupportGap, type TraverseRequest, type UpdateDomainObjectRequest, type UpdateOntologySchemaRequest };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindgraph",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "description": "TypeScript client for the MindGraph Cloud API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",