mindgraph 0.14.0 → 0.15.0

package/README.md

@@ -52,6 +52,10 @@ new MindGraph({ baseUrl: string, apiKey?: string, jwt?: string })
 |--------|-------------|
 | `capture(req)` | Capture a source, snippet, or observation |
 | `entity(req)` | Create, alias, resolve, or merge entities |
+| `series(req)` | Call the typed time-series action surface directly |
+| `createSeries` / `appendSeries` / `seriesWindow` | Create a Series, append sourced points, and page through a bounded time window |
+| `aggregateSeries` / `latestSeries` / `listSeriesForEntity` | Read bounded aggregates, cached latest values, and an entity's Series |
+| `batchLatestSeries` / `batchAggregateSeries` / `deleteSeries` | Compare Series across entities or tombstone a Series and its points |
 | `findOrCreateEntity(label, props?, agentId?)` | Convenience: create or find an entity by label (generic fallback) |
 | `findOrCreatePerson(label, props?, agentId?)` | Find or create a Person entity |
 | `findOrCreateOrganization(label, props?, agentId?)` | Find or create an Organization entity |
@@ -103,9 +107,25 @@ const entity = await graph.findOrCreateEntity("Some Entity");
 |--------|-------------|
 | `session(req)` | Open a session, record traces, or close a session |
 | `journal(label, props, options?)` | Record a journal entry linked to an optional session |
-| `distill(req)` | Create a Summary (default) or Lesson with source provenance |
+| `distill(req)` | Create a Summary, Lesson, or governed Skill candidate with source provenance |
 | `memoryConfig(req)` | Set/get preferences and memory policies |
 
+`output_type: "skill"` requires caller-authored SKILL.md content and at
+least one provenance field. It always creates a candidate for review:
+
+```typescript
+await graph.distill({
+  label: "Recover a malformed import",
+  output_type: "skill",
+  work_uid: "work_import_42",
+  props: {
+    name: "recover-malformed-import",
+    description: "Use after a spreadsheet import fails schema validation.",
+    content: "# Recovery\n\nValidate headers, normalize dates, then retry.",
+  },
+});
+```
+
 ### Agent Layer
 
 | Method | Description |
@@ -139,6 +159,7 @@ Define typed domain objects (Customer, Order, Contract…) as a semantic contrac
 |--------|-------------|
 | `proposeOntologySchema(req)` | Draft a schema from a description (+ optional sample docs); returns `{ schema_id, job_id }` |
 | `activateOntologySchema(id)` / `getOntologySchema(id)` / `listOntologySchemas()` | Schema lifecycle |
+| `createOntologySeriesBinding` / `syncOntologySeriesBinding` / `archiveOntologySeriesBinding` | Manage SQL-backed dense-measurement bindings |
 | `listOntologyProposals(opts?)` / `approveOntologyProposal(id)` / `rejectOntologyProposal(id)` | Review extracted-object proposals |
 | `queryOntology({ query, include_cognitive_context })` | Typed retrieval with the cognitive overlay fused in |
 | `listOntologyTools()` | The generated read-tool manifest (`search_/get_/summarize_<obj>`) the MCP server renders |

package/dist/index.d.mts

@@ -179,6 +179,47 @@ interface PlaceProps {
     identifiers?: Record<string, string>;
     attributes?: Record<string, unknown>;
 }
+interface FiscalYearEnd {
+    month: number;
+    day: number;
+}
+interface SeriesProps {
+    name: string;
+    description: string;
+    unit?: string | null;
+    temporality: "instant" | "period";
+    period_unit?: "year" | "quarter" | "month" | "week" | "day" | null;
+    fiscal_year_end: FiscalYearEnd;
+    value_kind: string;
+    default_source_uid?: string | null;
+    origin: "ingest" | "connector";
+    binding_uid?: string | null;
+    binding_name?: string | null;
+    n_points: number;
+    min_t?: number | null;
+    max_t?: number | null;
+    latest_t?: number | null;
+    latest_value?: number | null;
+    latest_period_label?: string | null;
+}
+type SeriesNode = Omit<GraphNode, "props"> & {
+    props: SeriesProps;
+};
+interface MeasurementPoint {
+    /** Microseconds since the Unix epoch (UTC). */
+    t: number;
+    value: number;
+    scale_applied?: number;
+    period_start?: number | null;
+    period_label?: string | null;
+    source_uid?: string | null;
+    source_ref?: string | null;
+}
+interface AggregatePoint {
+    /** UTC bucket start, microseconds since the Unix epoch. */
+    t: number;
+    value: number | null;
+}
 interface CaptureRequest {
     action: "source" | "snippet" | "observation";
     label: string;
@@ -212,6 +253,146 @@ interface EntityRequest {
     /** Explicit writable Project/repository/agent Space for an identity-backed create. */
     identity_space_uid?: string;
 }
+type SeriesRequest = {
+    action: "create";
+    entity_uid: string;
+    name: string;
+    description?: string;
+    unit?: string;
+    temporality: "instant" | "period";
+    period_unit?: "year" | "quarter" | "month" | "week" | "day";
+    fiscal_year_end?: FiscalYearEnd;
+    value_kind?: string;
+    default_source_uid?: string;
+    origin?: "ingest" | "connector";
+    space_uid?: string;
+    agent_id?: string;
+} | {
+    action: "append";
+    series_uid: string;
+    points: MeasurementPoint[];
+    agent_id?: string;
+} | {
+    action: "window";
+    series_uid: string;
+    from: number;
+    to: number;
+    cursor?: number;
+    limit?: number;
+    project_uid?: string;
+} | {
+    action: "aggregate";
+    series_uid: string;
+    from: number;
+    to: number;
+    bucket: "year" | "quarter" | "month" | "week" | "day" | "hour";
+    agg: "sum" | "mean" | "min" | "max" | "count" | "std_dev" | "last";
+    fill?: "none" | "null" | "prev";
+    project_uid?: string;
+} | {
+    action: "latest";
+    series_uid: string;
+    project_uid?: string;
+} | {
+    action: "list_for_entity";
+    entity_uid: string;
+    project_uid?: string;
+} | {
+    action: "batch_latest";
+    entity_uids: string[];
+    series_names?: string[];
+    project_uid?: string;
+} | {
+    action: "batch_aggregate";
+    series_uids: string[];
+    from: number;
+    to: number;
+    bucket: "year" | "quarter" | "month" | "week" | "day" | "hour";
+    agg: "sum" | "mean" | "min" | "max" | "count" | "std_dev" | "last";
+    fill?: "none" | "null" | "prev";
+    project_uid?: string;
+} | {
+    action: "delete_series";
+    series_uid: string;
+    reason?: string;
+    agent_id?: string;
+};
+interface CreateSeriesResponse {
+    created: boolean;
+    series: SeriesNode;
+}
+interface AppendSeriesResponse {
+    series_uid: string;
+    appended: number;
+    stats: Pick<SeriesProps, "n_points" | "min_t" | "max_t" | "latest_t" | "latest_value">;
+}
+interface SeriesWindowResponse {
+    series_uid: string;
+    from: number;
+    to: number;
+    points: MeasurementPoint[];
+    next_cursor: number | null;
+}
+interface SeriesAggregateResponse {
+    series_uid: string;
+    from: number;
+    to: number;
+    bucket: string;
+    agg: string;
+    fill: string;
+    estimated_scanned_points: number;
+    points: AggregatePoint[];
+}
+interface SeriesLatestResponse {
+    series_uid: string;
+    n_points: number;
+    min_t: number | null;
+    max_t: number | null;
+    latest_t: number | null;
+    latest_value: number | null;
+    latest_period_label: string | null;
+}
+interface ListSeriesResponse {
+    entity_uid: string;
+    series: SeriesNode[];
+}
+interface BatchLatestSeriesResponse {
+    entity_count: number;
+    series_names: string[];
+    rows: Array<{
+        entity_uid: string;
+        series_uid: string;
+        name: string;
+        unit: string | null;
+        temporality: string;
+        period_unit: string | null;
+        n_points: number;
+        latest_t: number | null;
+        latest_value: number | null;
+        latest_period_label: string | null;
+    }>;
+    coverage_complete: boolean;
+}
+interface BatchAggregateSeriesResponse {
+    from: number;
+    to: number;
+    bucket: string;
+    agg: string;
+    fill: string;
+    estimated_scanned_points: number;
+    series: Array<{
+        series_uid: string;
+        name: string;
+        unit: string | null;
+        estimated_scanned_points: number;
+        points: AggregatePoint[];
+    }>;
+}
+interface DeleteSeriesResponse {
+    series_uid: string;
+    deleted: boolean;
+    tombstoned_points: number;
+}
 interface ArgumentRequest {
     claim: {
         label: string;
@@ -344,10 +525,18 @@ interface SessionRequest {
     props?: Record<string, unknown>;
     agent_id?: string;
 }
-interface DistillRequest {
+/** Caller-authored content for a governed skill candidate. */
+interface SkillDistillProps {
+    /** Stable agentskills.io identifier: 1-64 lowercase letters, digits, or hyphens. */
+    name: string;
+    /** Human-readable trigger guidance (1-1024 characters; XML tags are rejected). */
+    description: string;
+    /** Complete SKILL.md body, capped by the server at 64 KiB. */
+    content: string;
+    license?: string;
+}
+interface DistillRequestBase {
     label: string;
-    /** Defaults to "summary" for backward compatibility. */
-    output_type?: "summary" | "lesson";
     summary?: string;
     confidence?: number;
     salience?: number;
@@ -357,9 +546,18 @@ interface DistillRequest {
     execution_uid?: string;
     idempotency_key?: string;
     supersedes_uid?: string;
-    props?: Record<string, unknown>;
     agent_id?: string;
 }
+interface SummaryOrLessonDistillRequest extends DistillRequestBase {
+    /** Defaults to "summary" for backward compatibility. */
+    output_type?: "summary" | "lesson";
+    props?: Record<string, unknown>;
+}
+interface SkillDistillRequest extends DistillRequestBase {
+    output_type: "skill";
+    props: SkillDistillProps;
+}
+type DistillRequest = SummaryOrLessonDistillRequest | SkillDistillRequest;
 interface MemoryConfigRequest {
     action: "set_preference" | "get_preferences" | "set_policy" | "get_policies";
     label?: string;
@@ -763,6 +961,30 @@ interface BelievedBy {
     /** The asserting agent's certainty in the claim, or null if unspecified. */
     confidence: number | null;
 }
+interface SeriesContextAnnotation {
+    uid: string;
+    name: string;
+    unit: string | null;
+    temporality: string;
+    origin: "ingest" | "connector" | string;
+    binding_name?: string | null;
+    /** Equivalent parallel Series; connector-backed entries sort first. */
+    same_metric_as?: Array<{
+        uid: string;
+        name: string;
+        origin: "ingest" | "connector" | string;
+        binding_name?: string | null;
+    }>;
+    /** Omitted for an empty Series (unknown is not zero). */
+    n_points?: number;
+    first_t?: number | null;
+    last_t?: number | null;
+    latest?: {
+        value: number | null;
+        t: number | null;
+        period_label: string | null;
+    };
+}
 interface RetrieveContextResponse {
     articles?: ArticleResult[];
     chunks?: {
@@ -785,6 +1007,7 @@ interface RetrieveContextResponse {
             }[];
             source_chunks?: SourceChunk[];
             believed_by?: BelievedBy[];
+            series?: SeriesContextAnnotation[];
             /** This node has been replaced by a newer value (Supersedes edge). */
             superseded?: boolean;
             /** UID of the node that superseded this one. */
@@ -1149,6 +1372,43 @@ interface BackingSync {
     /** null = manual "Sync now"; cron later. */
     schedule?: string | null;
 }
+interface SeriesBacking {
+    connection_ref: string;
+    table: string;
+    entity_key_column: string;
+    time_column: string;
+    value_column: string;
+    filter?: BackingFilter;
+    cursor_column?: string;
+}
+interface OntologySeriesBinding {
+    id: string;
+    schema_id: string;
+    org_id: string;
+    name: string;
+    entity_type: string;
+    unit?: string | null;
+    temporality: "instant" | "period";
+    period_unit?: "year" | "half" | "quarter" | "month" | "week" | "day" | null;
+    fiscal_year_end: {
+        month: number;
+        day: number;
+    };
+    backing: SeriesBacking;
+    cursor_value?: string | null;
+    last_domain_time?: string | null;
+    reconcile_periods: number;
+    last_source_keys: string[];
+    last_reconciliation?: {
+        deleted_source_keys: string[];
+        deleted_count: number;
+        policy: "rows_retained";
+        completed_at: string;
+    } | null;
+    status: "active" | "archived";
+    created_at: string;
+    updated_at: string;
+}
 /** Datasource binding for a relation type (FK column or M:M join table). */
 type RelationBacking = {
     kind: "sql_fk";
@@ -1240,6 +1500,7 @@ interface OntologyRelationType {
 interface OntologySchemaDetail extends OntologySchema {
     object_types: OntologyObjectType[];
     relation_types: OntologyRelationType[];
+    series_bindings: OntologySeriesBinding[];
 }
 /** A generated read-only tool descriptor (from `listOntologyTools`). */
 interface OntologyToolDescriptor {
@@ -1573,6 +1834,36 @@ declare class MindGraph {
     }): Promise<unknown>;
     capture(req: CaptureRequest): Promise<unknown>;
     entity(req: EntityRequest): Promise<unknown>;
+    series(req: SeriesRequest): Promise<unknown>;
+    createSeries(req: Omit<Extract<SeriesRequest, {
+        action: "create";
+    }>, "action">): Promise<CreateSeriesResponse>;
+    appendSeries(req: Omit<Extract<SeriesRequest, {
+        action: "append";
+    }>, "action">): Promise<AppendSeriesResponse>;
+    seriesWindow(req: Omit<Extract<SeriesRequest, {
+        action: "window";
+    }>, "action">): Promise<SeriesWindowResponse>;
+    aggregateSeries(req: Omit<Extract<SeriesRequest, {
+        action: "aggregate";
+    }>, "action">): Promise<SeriesAggregateResponse>;
+    latestSeries(seriesUid: string, options?: {
+        project_uid?: string;
+    }): Promise<SeriesLatestResponse>;
+    listSeriesForEntity(entityUid: string, options?: {
+        project_uid?: string;
+    }): Promise<ListSeriesResponse>;
+    batchLatestSeries(entityUids: string[], options?: {
+        series_names?: string[];
+        project_uid?: string;
+    }): Promise<BatchLatestSeriesResponse>;
+    batchAggregateSeries(req: Omit<Extract<SeriesRequest, {
+        action: "batch_aggregate";
+    }>, "action">): Promise<BatchAggregateSeriesResponse>;
+    deleteSeries(seriesUid: string, options?: {
+        reason?: string;
+        agent_id?: string;
+    }): Promise<DeleteSeriesResponse>;
     /** Convenience: create or find an entity by label. */
     findOrCreateEntity(label: string, props?: Record<string, unknown>, agentId?: string): Promise<GraphNode & {
         created: boolean;
@@ -1950,6 +2241,23 @@ declare class MindGraph {
         items: OntologySchema[];
     }>;
     getOntologySchema(id: string): Promise<OntologySchemaDetail>;
+    createOntologySeriesBinding(schemaId: string, request: {
+        name: string;
+        entity_type: string;
+        unit?: string;
+        temporality?: "instant" | "period";
+        period_unit?: "year" | "half" | "quarter" | "month" | "week" | "day";
+        fiscal_year_end?: {
+            month: number;
+            day: number;
+        };
+        backing: SeriesBacking;
+        reconcile_periods?: number;
+    }): Promise<OntologySeriesBinding>;
+    syncOntologySeriesBinding(bindingId: string, mode?: "incremental" | "full"): Promise<{
+        sync_job_id: string;
+    }>;
+    archiveOntologySeriesBinding(schemaId: string, bindingId: string): Promise<void>;
     createOntologySchema(req: CreateOntologySchemaRequest): Promise<OntologySchema>;
     updateOntologySchema(id: string, req: UpdateOntologySchemaRequest): Promise<OntologySchema>;
     activateOntologySchema(id: string): Promise<OntologySchema>;
@@ -2119,4 +2427,4 @@ declare class MindGraph {
     }>;
 }
 
-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 GovernanceTarget, type GraphEdge, type GraphNode, type IngestChunkRequest, type IngestChunkResponse, type IngestDocumentRequest, type IngestDocumentResponse, type IngestSessionRequest, type InquiryRequest, type Job, type ListArticlesResponse, 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 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 };
+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 CreateOntologySchemaRequest, type CreateSeriesResponse, type DecayRequest, type DeleteSeriesResponse, 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 FiscalYearEnd, 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 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 UpdateOntologySchemaRequest };

package/dist/index.d.ts

@@ -179,6 +179,47 @@ interface PlaceProps {
     identifiers?: Record<string, string>;
     attributes?: Record<string, unknown>;
 }
+interface FiscalYearEnd {
+    month: number;
+    day: number;
+}
+interface SeriesProps {
+    name: string;
+    description: string;
+    unit?: string | null;
+    temporality: "instant" | "period";
+    period_unit?: "year" | "quarter" | "month" | "week" | "day" | null;
+    fiscal_year_end: FiscalYearEnd;
+    value_kind: string;
+    default_source_uid?: string | null;
+    origin: "ingest" | "connector";
+    binding_uid?: string | null;
+    binding_name?: string | null;
+    n_points: number;
+    min_t?: number | null;
+    max_t?: number | null;
+    latest_t?: number | null;
+    latest_value?: number | null;
+    latest_period_label?: string | null;
+}
+type SeriesNode = Omit<GraphNode, "props"> & {
+    props: SeriesProps;
+};
+interface MeasurementPoint {
+    /** Microseconds since the Unix epoch (UTC). */
+    t: number;
+    value: number;
+    scale_applied?: number;
+    period_start?: number | null;
+    period_label?: string | null;
+    source_uid?: string | null;
+    source_ref?: string | null;
+}
+interface AggregatePoint {
+    /** UTC bucket start, microseconds since the Unix epoch. */
+    t: number;
+    value: number | null;
+}
 interface CaptureRequest {
     action: "source" | "snippet" | "observation";
     label: string;
@@ -212,6 +253,146 @@ interface EntityRequest {
     /** Explicit writable Project/repository/agent Space for an identity-backed create. */
     identity_space_uid?: string;
 }
+type SeriesRequest = {
+    action: "create";
+    entity_uid: string;
+    name: string;
+    description?: string;
+    unit?: string;
+    temporality: "instant" | "period";
+    period_unit?: "year" | "quarter" | "month" | "week" | "day";
+    fiscal_year_end?: FiscalYearEnd;
+    value_kind?: string;
+    default_source_uid?: string;
+    origin?: "ingest" | "connector";
+    space_uid?: string;
+    agent_id?: string;
+} | {
+    action: "append";
+    series_uid: string;
+    points: MeasurementPoint[];
+    agent_id?: string;
+} | {
+    action: "window";
+    series_uid: string;
+    from: number;
+    to: number;
+    cursor?: number;
+    limit?: number;
+    project_uid?: string;
+} | {
+    action: "aggregate";
+    series_uid: string;
+    from: number;
+    to: number;
+    bucket: "year" | "quarter" | "month" | "week" | "day" | "hour";
+    agg: "sum" | "mean" | "min" | "max" | "count" | "std_dev" | "last";
+    fill?: "none" | "null" | "prev";
+    project_uid?: string;
+} | {
+    action: "latest";
+    series_uid: string;
+    project_uid?: string;
+} | {
+    action: "list_for_entity";
+    entity_uid: string;
+    project_uid?: string;
+} | {
+    action: "batch_latest";
+    entity_uids: string[];
+    series_names?: string[];
+    project_uid?: string;
+} | {
+    action: "batch_aggregate";
+    series_uids: string[];
+    from: number;
+    to: number;
+    bucket: "year" | "quarter" | "month" | "week" | "day" | "hour";
+    agg: "sum" | "mean" | "min" | "max" | "count" | "std_dev" | "last";
+    fill?: "none" | "null" | "prev";
+    project_uid?: string;
+} | {
+    action: "delete_series";
+    series_uid: string;
+    reason?: string;
+    agent_id?: string;
+};
+interface CreateSeriesResponse {
+    created: boolean;
+    series: SeriesNode;
+}
+interface AppendSeriesResponse {
+    series_uid: string;
+    appended: number;
+    stats: Pick<SeriesProps, "n_points" | "min_t" | "max_t" | "latest_t" | "latest_value">;
+}
+interface SeriesWindowResponse {
+    series_uid: string;
+    from: number;
+    to: number;
+    points: MeasurementPoint[];
+    next_cursor: number | null;
+}
+interface SeriesAggregateResponse {
+    series_uid: string;
+    from: number;
+    to: number;
+    bucket: string;
+    agg: string;
+    fill: string;
+    estimated_scanned_points: number;
+    points: AggregatePoint[];
+}
+interface SeriesLatestResponse {
+    series_uid: string;
+    n_points: number;
+    min_t: number | null;
+    max_t: number | null;
+    latest_t: number | null;
+    latest_value: number | null;
+    latest_period_label: string | null;
+}
+interface ListSeriesResponse {
+    entity_uid: string;
+    series: SeriesNode[];
+}
+interface BatchLatestSeriesResponse {
+    entity_count: number;
+    series_names: string[];
+    rows: Array<{
+        entity_uid: string;
+        series_uid: string;
+        name: string;
+        unit: string | null;
+        temporality: string;
+        period_unit: string | null;
+        n_points: number;
+        latest_t: number | null;
+        latest_value: number | null;
+        latest_period_label: string | null;
+    }>;
+    coverage_complete: boolean;
+}
+interface BatchAggregateSeriesResponse {
+    from: number;
+    to: number;
+    bucket: string;
+    agg: string;
+    fill: string;
+    estimated_scanned_points: number;
+    series: Array<{
+        series_uid: string;
+        name: string;
+        unit: string | null;
+        estimated_scanned_points: number;
+        points: AggregatePoint[];
+    }>;
+}
+interface DeleteSeriesResponse {
+    series_uid: string;
+    deleted: boolean;
+    tombstoned_points: number;
+}
 interface ArgumentRequest {
     claim: {
         label: string;
@@ -344,10 +525,18 @@ interface SessionRequest {
     props?: Record<string, unknown>;
     agent_id?: string;
 }
-interface DistillRequest {
+/** Caller-authored content for a governed skill candidate. */
+interface SkillDistillProps {
+    /** Stable agentskills.io identifier: 1-64 lowercase letters, digits, or hyphens. */
+    name: string;
+    /** Human-readable trigger guidance (1-1024 characters; XML tags are rejected). */
+    description: string;
+    /** Complete SKILL.md body, capped by the server at 64 KiB. */
+    content: string;
+    license?: string;
+}
+interface DistillRequestBase {
     label: string;
-    /** Defaults to "summary" for backward compatibility. */
-    output_type?: "summary" | "lesson";
     summary?: string;
     confidence?: number;
     salience?: number;
@@ -357,9 +546,18 @@ interface DistillRequest {
     execution_uid?: string;
     idempotency_key?: string;
     supersedes_uid?: string;
-    props?: Record<string, unknown>;
     agent_id?: string;
 }
+interface SummaryOrLessonDistillRequest extends DistillRequestBase {
+    /** Defaults to "summary" for backward compatibility. */
+    output_type?: "summary" | "lesson";
+    props?: Record<string, unknown>;
+}
+interface SkillDistillRequest extends DistillRequestBase {
+    output_type: "skill";
+    props: SkillDistillProps;
+}
+type DistillRequest = SummaryOrLessonDistillRequest | SkillDistillRequest;
 interface MemoryConfigRequest {
     action: "set_preference" | "get_preferences" | "set_policy" | "get_policies";
     label?: string;
@@ -763,6 +961,30 @@ interface BelievedBy {
     /** The asserting agent's certainty in the claim, or null if unspecified. */
     confidence: number | null;
 }
+interface SeriesContextAnnotation {
+    uid: string;
+    name: string;
+    unit: string | null;
+    temporality: string;
+    origin: "ingest" | "connector" | string;
+    binding_name?: string | null;
+    /** Equivalent parallel Series; connector-backed entries sort first. */
+    same_metric_as?: Array<{
+        uid: string;
+        name: string;
+        origin: "ingest" | "connector" | string;
+        binding_name?: string | null;
+    }>;
+    /** Omitted for an empty Series (unknown is not zero). */
+    n_points?: number;
+    first_t?: number | null;
+    last_t?: number | null;
+    latest?: {
+        value: number | null;
+        t: number | null;
+        period_label: string | null;
+    };
+}
 interface RetrieveContextResponse {
     articles?: ArticleResult[];
     chunks?: {
@@ -785,6 +1007,7 @@ interface RetrieveContextResponse {
             }[];
             source_chunks?: SourceChunk[];
             believed_by?: BelievedBy[];
+            series?: SeriesContextAnnotation[];
             /** This node has been replaced by a newer value (Supersedes edge). */
             superseded?: boolean;
             /** UID of the node that superseded this one. */
@@ -1149,6 +1372,43 @@ interface BackingSync {
     /** null = manual "Sync now"; cron later. */
     schedule?: string | null;
 }
+interface SeriesBacking {
+    connection_ref: string;
+    table: string;
+    entity_key_column: string;
+    time_column: string;
+    value_column: string;
+    filter?: BackingFilter;
+    cursor_column?: string;
+}
+interface OntologySeriesBinding {
+    id: string;
+    schema_id: string;
+    org_id: string;
+    name: string;
+    entity_type: string;
+    unit?: string | null;
+    temporality: "instant" | "period";
+    period_unit?: "year" | "half" | "quarter" | "month" | "week" | "day" | null;
+    fiscal_year_end: {
+        month: number;
+        day: number;
+    };
+    backing: SeriesBacking;
+    cursor_value?: string | null;
+    last_domain_time?: string | null;
+    reconcile_periods: number;
+    last_source_keys: string[];
+    last_reconciliation?: {
+        deleted_source_keys: string[];
+        deleted_count: number;
+        policy: "rows_retained";
+        completed_at: string;
+    } | null;
+    status: "active" | "archived";
+    created_at: string;
+    updated_at: string;
+}
 /** Datasource binding for a relation type (FK column or M:M join table). */
 type RelationBacking = {
     kind: "sql_fk";
@@ -1240,6 +1500,7 @@ interface OntologyRelationType {
 interface OntologySchemaDetail extends OntologySchema {
     object_types: OntologyObjectType[];
     relation_types: OntologyRelationType[];
+    series_bindings: OntologySeriesBinding[];
 }
 /** A generated read-only tool descriptor (from `listOntologyTools`). */
 interface OntologyToolDescriptor {
@@ -1573,6 +1834,36 @@ declare class MindGraph {
     }): Promise<unknown>;
     capture(req: CaptureRequest): Promise<unknown>;
     entity(req: EntityRequest): Promise<unknown>;
+    series(req: SeriesRequest): Promise<unknown>;
+    createSeries(req: Omit<Extract<SeriesRequest, {
+        action: "create";
+    }>, "action">): Promise<CreateSeriesResponse>;
+    appendSeries(req: Omit<Extract<SeriesRequest, {
+        action: "append";
+    }>, "action">): Promise<AppendSeriesResponse>;
+    seriesWindow(req: Omit<Extract<SeriesRequest, {
+        action: "window";
+    }>, "action">): Promise<SeriesWindowResponse>;
+    aggregateSeries(req: Omit<Extract<SeriesRequest, {
+        action: "aggregate";
+    }>, "action">): Promise<SeriesAggregateResponse>;
+    latestSeries(seriesUid: string, options?: {
+        project_uid?: string;
+    }): Promise<SeriesLatestResponse>;
+    listSeriesForEntity(entityUid: string, options?: {
+        project_uid?: string;
+    }): Promise<ListSeriesResponse>;
+    batchLatestSeries(entityUids: string[], options?: {
+        series_names?: string[];
+        project_uid?: string;
+    }): Promise<BatchLatestSeriesResponse>;
+    batchAggregateSeries(req: Omit<Extract<SeriesRequest, {
+        action: "batch_aggregate";
+    }>, "action">): Promise<BatchAggregateSeriesResponse>;
+    deleteSeries(seriesUid: string, options?: {
+        reason?: string;
+        agent_id?: string;
+    }): Promise<DeleteSeriesResponse>;
     /** Convenience: create or find an entity by label. */
     findOrCreateEntity(label: string, props?: Record<string, unknown>, agentId?: string): Promise<GraphNode & {
         created: boolean;
@@ -1950,6 +2241,23 @@ declare class MindGraph {
         items: OntologySchema[];
     }>;
     getOntologySchema(id: string): Promise<OntologySchemaDetail>;
+    createOntologySeriesBinding(schemaId: string, request: {
+        name: string;
+        entity_type: string;
+        unit?: string;
+        temporality?: "instant" | "period";
+        period_unit?: "year" | "half" | "quarter" | "month" | "week" | "day";
+        fiscal_year_end?: {
+            month: number;
+            day: number;
+        };
+        backing: SeriesBacking;
+        reconcile_periods?: number;
+    }): Promise<OntologySeriesBinding>;
+    syncOntologySeriesBinding(bindingId: string, mode?: "incremental" | "full"): Promise<{
+        sync_job_id: string;
+    }>;
+    archiveOntologySeriesBinding(schemaId: string, bindingId: string): Promise<void>;
     createOntologySchema(req: CreateOntologySchemaRequest): Promise<OntologySchema>;
     updateOntologySchema(id: string, req: UpdateOntologySchemaRequest): Promise<OntologySchema>;
     activateOntologySchema(id: string): Promise<OntologySchema>;
@@ -2119,4 +2427,4 @@ declare class MindGraph {
     }>;
 }
 
-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 GovernanceTarget, type GraphEdge, type GraphNode, type IngestChunkRequest, type IngestChunkResponse, type IngestDocumentRequest, type IngestDocumentResponse, type IngestSessionRequest, type InquiryRequest, type Job, type ListArticlesResponse, 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 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 };
+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 CreateOntologySchemaRequest, type CreateSeriesResponse, type DecayRequest, type DeleteSeriesResponse, 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 FiscalYearEnd, 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 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 UpdateOntologySchemaRequest };

package/dist/index.js

@@ -86,7 +86,8 @@ var MindGraph = class {
         );
         if (res.status === 503 && attempt < this.maxRetries) {
           lastError = err;
-          const delay = this.retryBackoffMs * 2 ** attempt;
+          const retryAfterSecs = Number(res.headers.get("retry-after"));
+          const delay = Number.isFinite(retryAfterSecs) && retryAfterSecs > 0 ? Math.min(retryAfterSecs * 1e3, 1e4) : this.retryBackoffMs * 2 ** attempt;
           await new Promise((r) => setTimeout(r, delay));
           continue;
         }
@@ -137,6 +138,52 @@ var MindGraph = class {
   async entity(req) {
     return this.post("/reality/entity", req);
   }
+  async series(req) {
+    return this.post("/reality/series", req);
+  }
+  async createSeries(req) {
+    return this.post("/reality/series", { action: "create", ...req });
+  }
+  async appendSeries(req) {
+    return this.post("/reality/series", { action: "append", ...req });
+  }
+  async seriesWindow(req) {
+    return this.post("/reality/series", { action: "window", ...req });
+  }
+  async aggregateSeries(req) {
+    return this.post("/reality/series", { action: "aggregate", ...req });
+  }
+  async latestSeries(seriesUid, options) {
+    return this.post("/reality/series", {
+      action: "latest",
+      series_uid: seriesUid,
+      ...options
+    });
+  }
+  async listSeriesForEntity(entityUid, options) {
+    return this.post("/reality/series", {
+      action: "list_for_entity",
+      entity_uid: entityUid,
+      ...options
+    });
+  }
+  async batchLatestSeries(entityUids, options) {
+    return this.post("/reality/series", {
+      action: "batch_latest",
+      entity_uids: entityUids,
+      ...options
+    });
+  }
+  async batchAggregateSeries(req) {
+    return this.post("/reality/series", { action: "batch_aggregate", ...req });
+  }
+  async deleteSeries(seriesUid, options) {
+    return this.post("/reality/series", {
+      action: "delete_series",
+      series_uid: seriesUid,
+      ...options
+    });
+  }
   /** Convenience: create or find an entity by label. */
   async findOrCreateEntity(label, props, agentId) {
     return this.post("/reality/entity", {
@@ -706,6 +753,20 @@ var MindGraph = class {
   async getOntologySchema(id) {
     return this.get(`/v1/ontology/schemas/${seg(id)}`);
   }
+  async createOntologySeriesBinding(schemaId, request) {
+    return this.post(`/v1/ontology/schemas/${seg(schemaId)}/series-bindings`, request);
+  }
+  async syncOntologySeriesBinding(bindingId, mode) {
+    return this.post(
+      `/v1/ontology/series-bindings/${seg(bindingId)}/sync`,
+      mode ? { mode } : {}
+    );
+  }
+  async archiveOntologySeriesBinding(schemaId, bindingId) {
+    return this.del(
+      `/v1/ontology/schemas/${seg(schemaId)}/series-bindings/${seg(bindingId)}`
+    );
+  }
   async createOntologySchema(req) {
     return this.post("/v1/ontology/schemas", req);
   }

package/dist/index.mjs

@@ -59,7 +59,8 @@ var MindGraph = class {
         );
         if (res.status === 503 && attempt < this.maxRetries) {
           lastError = err;
-          const delay = this.retryBackoffMs * 2 ** attempt;
+          const retryAfterSecs = Number(res.headers.get("retry-after"));
+          const delay = Number.isFinite(retryAfterSecs) && retryAfterSecs > 0 ? Math.min(retryAfterSecs * 1e3, 1e4) : this.retryBackoffMs * 2 ** attempt;
           await new Promise((r) => setTimeout(r, delay));
           continue;
         }
@@ -110,6 +111,52 @@ var MindGraph = class {
   async entity(req) {
     return this.post("/reality/entity", req);
   }
+  async series(req) {
+    return this.post("/reality/series", req);
+  }
+  async createSeries(req) {
+    return this.post("/reality/series", { action: "create", ...req });
+  }
+  async appendSeries(req) {
+    return this.post("/reality/series", { action: "append", ...req });
+  }
+  async seriesWindow(req) {
+    return this.post("/reality/series", { action: "window", ...req });
+  }
+  async aggregateSeries(req) {
+    return this.post("/reality/series", { action: "aggregate", ...req });
+  }
+  async latestSeries(seriesUid, options) {
+    return this.post("/reality/series", {
+      action: "latest",
+      series_uid: seriesUid,
+      ...options
+    });
+  }
+  async listSeriesForEntity(entityUid, options) {
+    return this.post("/reality/series", {
+      action: "list_for_entity",
+      entity_uid: entityUid,
+      ...options
+    });
+  }
+  async batchLatestSeries(entityUids, options) {
+    return this.post("/reality/series", {
+      action: "batch_latest",
+      entity_uids: entityUids,
+      ...options
+    });
+  }
+  async batchAggregateSeries(req) {
+    return this.post("/reality/series", { action: "batch_aggregate", ...req });
+  }
+  async deleteSeries(seriesUid, options) {
+    return this.post("/reality/series", {
+      action: "delete_series",
+      series_uid: seriesUid,
+      ...options
+    });
+  }
   /** Convenience: create or find an entity by label. */
   async findOrCreateEntity(label, props, agentId) {
     return this.post("/reality/entity", {
@@ -679,6 +726,20 @@ var MindGraph = class {
   async getOntologySchema(id) {
     return this.get(`/v1/ontology/schemas/${seg(id)}`);
   }
+  async createOntologySeriesBinding(schemaId, request) {
+    return this.post(`/v1/ontology/schemas/${seg(schemaId)}/series-bindings`, request);
+  }
+  async syncOntologySeriesBinding(bindingId, mode) {
+    return this.post(
+      `/v1/ontology/series-bindings/${seg(bindingId)}/sync`,
+      mode ? { mode } : {}
+    );
+  }
+  async archiveOntologySeriesBinding(schemaId, bindingId) {
+    return this.del(
+      `/v1/ontology/schemas/${seg(schemaId)}/series-bindings/${seg(bindingId)}`
+    );
+  }
   async createOntologySchema(req) {
     return this.post("/v1/ontology/schemas", req);
   }

package/package.json

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