@odla-ai/kg 0.2.4 → 0.3.2

package/dist/index.d.cts

@@ -1,123 +1,47 @@
-import { Value, Op, AdminDb, SerializedAttr, Cardinality, SerializedSchema, Entity } from '@odla-ai/db';
-import { Ai } from '@odla-ai/ai';
-
-/**
- * The output of a connector: one acquired item. Exactly one of `text` or
- * `fragment` is set — `text` goes through LLM extraction, `fragment` is already
- * ontology-typed and goes straight to the graph writer (structured feeds).
- */
-interface RawItem {
-    url: string;
-    title: string;
-    date?: string;
-    sourceName: string;
-    sourceKind: string;
-    watch?: string | null;
-    text?: string;
-    fragment?: GraphFragment;
-}
-/** A graph node = an odla-db entity in a namespace, keyed by a natural key. */
-interface GraphNode {
-    type: string;
-    key: string;
-    attrs: Record<string, Value>;
-}
-/** A graph edge = an odla-db `link` from one node to another by forward label. */
-interface GraphEdge {
-    from: {
-        type: string;
-        key: string;
+import { O as Ontology, G as GraphFragment, M as MergeRule, P as Provider, S as SourceConnector, C as ConnectorContext, R as RawItem, a as SourceEntry, E as ExtractResult } from './sources-nJyD0JUP.cjs';
+export { A as AttrSpec, b as AttrType, c as ConnectorJob, d as EdgeSpec, e as EntitySpec, f as ExtractCall, g as GraphEdge, h as GraphNode, L as LlmConfig, i as LlmEnv, j as MODEL_TIERS, N as NaturalKeys, k as ProviderFamily, l as SearchCall, U as Usage, W as WriteCall, m as addUsage, n as allJobs, o as createProvider, p as emptyUsage, q as enabledSources, r as fragmentToOps, s as getProvider, t as humanAttrsOf, u as jobsForHour, v as mergeRulesOf, w as naturalKeysOf, x as toSerializedSchema, y as writeFragment } from './sources-nJyD0JUP.cjs';
+import { AdminDb, Value, Entity } from '@odla-ai/db';
+import '@odla-ai/ai';
+
+/** One entity type to export. */
+interface ExportEntitySpec {
+    /** Link labels (forward or reverse, as queried in InstaQL) to pull as nested rows. */
+    links?: readonly string[];
+    /** Attr allowlist kept on nodes. Default: every scalar attr except `id` and links. */
+    attrs?: readonly string[];
+    /**
+     * Date window. Filtering is client-side by default; set `indexed: true`
+     * (only when the attr really is indexed) to also push a
+     * `where { [dateAttr]: { $gte: from } }` to the server — odla-db silently
+     * returns zero rows for `where` on unindexed attrs.
+     */
+    window?: {
+        dateAttr: string;
+        from: string;
+        indexed?: boolean;
     };
-    to: {
-        type: string;
-        key: string;
-    };
-    label: string;
-}
-/** The single shape the graph writer consumes, whatever produced it. */
-interface GraphFragment {
-    nodes: GraphNode[];
-    edges: GraphEdge[];
-}
-/** What an extractor turns a text RawItem into: a fragment plus a prose summary. */
-interface ExtractResult {
-    fragment: GraphFragment;
-    summary: string;
+    /** Row cap for this type across the offset walk. Default 1000. */
+    limit?: number;
 }
-/** Provider-agnostic LLM usage accounting. */
-interface Usage {
-    calls: number;
-    inputTokens: number;
-    outputTokens: number;
+/** What {@link exportFragment} should read. */
+interface ExportSpec {
+    entities: Record<string, ExportEntitySpec>;
+    /** Rows per page in the offset walk (1–1000). Default 200. */
+    pageSize?: number;
 }
-/** Create zeroed provider-agnostic usage totals for one pipeline run. */
-declare function emptyUsage(): Usage;
-/** Mutate an accumulator by adding call, input-token, and output-token totals. */
-declare function addUsage(into: Usage, more: Usage): void;
-
-/** node type → unique natural-key attribute name. */
-type NaturalKeys = Record<string, string>;
 /**
- * Pure fragment → ops mapping (no read/merge). Node upserts by Lookup natural
- * key, then links — nodes always before links so `link` targets resolve.
- * Used by tests and as the building block for the provenance path below.
+ * Export (a window of) the graph as a `GraphFragment` — nodes and forward
+ * edges — ready for `extractEvents` and the rest of `@odla-ai/kg/temporal`.
+ *
+ * Each entity type is read with a stable offset walk (ordered by its natural
+ * key) carrying its requested link labels as nested relations. Date windows
+ * filter client-side; for attrs declared `indexed` the filter also runs
+ * server-side, and if that indexed filter ever exceeds the scan budget
+ * (`query_scan_limit`) the walk restarts without `where`.
+ * Nodes dedupe by `type:key` keeping the richer attr set; output ordering is
+ * deterministic (nodes by type/key, edges by from/label/to).
  */
-declare function fragmentToOps(fragment: GraphFragment, keys: NaturalKeys): Op[];
-/**
- * Provenance-preserving write. Reads existing nodes by natural key (one batched
- * query), merges scalar attrs per the ontology's rules, drops human-owned
- * attrs, then writes merged node updates + all links in one atomic, idempotent
- * transaction. `mutationId` must be deterministic so odla-db can deduplicate
- * the write on retry; this does not make preceding reads or external effects
- * exactly-once.
- */
-declare function writeFragment(db: AdminDb, fragment: GraphFragment, ontology: Ontology, mutationId: string): Promise<{
-    txId: number;
-    ops: number;
-}>;
-
-/** How a scalar attribute is reconciled when a node is re-discovered. */
-type MergeRule = "replace" | "prefer" | "earliest" | "latest";
-type AttrType = SerializedAttr["type"];
-interface AttrSpec {
-    type: AttrType;
-    unique?: boolean;
-    indexed?: boolean;
-    optional?: boolean;
-    /** The pipeline NEVER writes this attr (hand-edited in a UI); omitted from every update. */
-    human?: boolean;
-    /** Provenance rule for re-discovery. Default "replace". */
-    merge?: MergeRule;
-    /** Shown to the LLM when this attr appears in an extraction schema. */
-    desc?: string;
-}
-interface EntitySpec {
-    /** Unique attr used for Lookup upsert (MERGE key). Must be `unique` in attrs. */
-    naturalKey: string;
-    attrs: Record<string, AttrSpec>;
-    /** FTS fields for fuzzy resolution (P5). */
-    searchable?: string[];
-}
-interface EdgeSpec {
-    from: string;
-    to: string;
-    forwardLabel: string;
-    reverseLabel: string;
-    forwardHas?: Cardinality;
-    reverseHas?: Cardinality;
-}
-interface Ontology {
-    entities: Record<string, EntitySpec>;
-    edges: Record<string, EdgeSpec>;
-}
-/** node type → natural-key attr name (for the graph writer's Lookup refs). */
-declare function naturalKeysOf(o: Ontology): NaturalKeys;
-/** Attr name → merge rule, for every entity type (used by the provenance writer). */
-declare function mergeRulesOf(o: Ontology): Record<string, Record<string, MergeRule>>;
-/** Attr names the pipeline must never write, per entity type. */
-declare function humanAttrsOf(o: Ontology): Record<string, Set<string>>;
-/** Compile the ontology to an odla-db SerializedSchema to POST at /app/:id/schema. */
-declare function toSerializedSchema(o: Ontology): SerializedSchema;
+declare function exportFragment(db: AdminDb, ontology: Ontology, spec: ExportSpec): Promise<GraphFragment>;
 
 /**
  * Reconcile one scalar attribute when a node is re-discovered. Port of agnacl's
@@ -147,83 +71,6 @@ declare function resolveName(db: AdminDb, type: string, keyAttr: string, name: s
  */
 declare function canonicalizeFragment(db: AdminDb, fragment: GraphFragment, ontology: Ontology): Promise<GraphFragment>;
 
-/**
- * The LLM seam, now a thin adapter over @odla-ai/ai (which was itself
- * generalized from this package's original Provider). Three verbs stay:
- * extract (forced structured tool call), search (web-search-enabled text),
- * write (plain generation). Callers never see vendor or oracle types.
- */
-type ProviderFamily = "claude" | "openai";
-/** Role → model tiers per family — config as data. `cheap` is for gate-style
- * calls, `extract` for structured extraction (and prose writing), `search`
- * for web-search-enabled calls. */
-declare const MODEL_TIERS: Record<ProviderFamily, {
-    cheap: string;
-    extract: string;
-    search: string;
-}>;
-/** A forced structured tool call: schema in, validated object out. */
-interface ExtractCall {
-    system: string;
-    user: string;
-    tool: {
-        name: string;
-        description?: string;
-        parameters: Record<string, unknown>;
-    };
-    model?: string;
-    maxTokens?: number;
-}
-/** A web-search-enabled call: the model searches and returns text (caller tolerant-parses). */
-interface SearchCall {
-    system: string;
-    user: string;
-    model?: string;
-    maxTokens?: number;
-}
-/** A plain text-generation call (no tools, no search) — e.g. digest prose. */
-interface WriteCall {
-    system: string;
-    user: string;
-    model?: string;
-    maxTokens?: number;
-}
-interface Provider {
-    id: ProviderFamily;
-    /** The underlying @odla-ai/ai client — escape hatch for advanced use. */
-    ai: Ai;
-    extract<T = unknown>(c: ExtractCall): Promise<{
-        value: T;
-        usage: Usage;
-    }>;
-    search(c: SearchCall): Promise<{
-        text: string;
-        usage: Usage;
-    }>;
-    write(c: WriteCall): Promise<{
-        text: string;
-        usage: Usage;
-    }>;
-}
-interface LlmConfig {
-    provider: ProviderFamily;
-    anthropicKey?: string;
-    openaiKey?: string;
-    /** Inject a pre-built Ai (tests, custom catalog); keys are ignored when set. */
-    ai?: Ai;
-}
-/** The library primitive: an explicit config in, the three-verb seam out. */
-declare function createProvider(cfg: LlmConfig): Provider;
-/** The env vars the provider factory reads — a structural slice, not the
- * worker Env, so any host (worker, script, test) can supply plain strings. */
-interface LlmEnv {
-    LLM_PROVIDER?: string;
-    ANTHROPIC_API_KEY?: string;
-    OPENAI_API_KEY?: string;
-}
-/** Build the configured provider from host env, failing before use when its key is missing. */
-declare function getProvider(env: LlmEnv): Provider;
-
 /**
  * Tolerant JSON extraction from LLM prose — web-search models return JSON inside
  * explanatory text. Ported from agnacl services/enrichment.ts.
@@ -232,41 +79,6 @@ declare function extractJson<T = unknown>(text: string): T | null;
 /** Tolerantly parse the first JSON-array-shaped span in model prose, or return an empty array. */
 declare function extractJsonArray<T = unknown>(text: string): T[];
 
-/** Ambient services a connector may use. Host-agnostic: secrets come through
- * secret(), never a worker Env, so the library runs anywhere. */
-interface ConnectorContext {
-    now: Date;
-    fetchText(url: string): Promise<string>;
-    secret(name: string): string | undefined;
-    ontology: Ontology;
-    /** The configured LLM provider (lazy — only web-search/discovery connectors need it). */
-    provider(): Provider;
-}
-/**
- * The extensibility seam. A connector emits normalized RawItems — text-bearing
- * (→ LLM extraction) or fragment-bearing (structured → straight to the writer).
- * Adding a source = a new module implementing this + one registry line.
- */
-interface SourceConnector<Cfg = unknown> {
-    id: string;
-    capabilities: {
-        fetch: boolean;
-        discover?: boolean;
-        structured: boolean;
-    };
-    parseConfig(raw: unknown): Cfg;
-    fetch(cfg: Cfg, ctx: ConnectorContext): Promise<RawItem[]>;
-    /** Web-search-style net-new discovery (P4). */
-    discover?(cfg: Cfg, ctx: ConnectorContext): Promise<RawItem[]>;
-}
-/** One unit of work for the ingest workflow: which connector + its config. */
-interface ConnectorJob {
-    kind: string;
-    name: string;
-    watch?: string | null;
-    cfg: unknown;
-}
-
 /** Resolve a built-in source connector by its stable registry id. */
 declare function getConnector(id: string): SourceConnector | undefined;
 /** List registered connector ids in deterministic insertion order. */
@@ -285,28 +97,6 @@ declare function makeContext(cfg: ContextConfig): ConnectorContext;
 /** Fetch one URL → a text-bearing RawItem. Used both directly (/trigger) and as a connector. */
 declare function fetchUrl(url: string): Promise<RawItem>;
 
-/**
- * Sources are DATA, not code. Each entry names a connector (`kind`) + its config
- * + scheduling. Add a feed → add an entry; no redeploy of the pipeline. P5 moves
- * this into KV behind a /config admin endpoint so edits don't need a deploy at all.
- */
-interface SourceEntry {
-    kind: string;
-    name: string;
-    enabled?: boolean;
-    cadenceHours?: number;
-    watch?: string | null;
-    url?: string;
-    query?: string;
-    [key: string]: unknown;
-}
-/** Return source entries not explicitly disabled, preserving configured order. */
-declare function enabledSources(sources: SourceEntry[]): SourceEntry[];
-/** Enabled sources whose cadence lands on this UTC hour. */
-declare function jobsForHour(sources: SourceEntry[], hour: number): ConnectorJob[];
-/** Every enabled source, ignoring cadence (manual /trigger?kind=sources). */
-declare function allJobs(sources: SourceEntry[]): ConnectorJob[];
-
 /**
  * The slice of a KV store the pipeline needs. Cloudflare's KVNamespace
  * satisfies it structurally; tests pass an in-memory map. Keeping the library
@@ -338,6 +128,10 @@ declare class Store {
     /** Runtime source config (edit without redeploy). null = fall back to the static SOURCES. */
     getConfigSources(): Promise<SourceEntry[] | null>;
     setConfigSources(list: SourceEntry[]): Promise<void>;
+    /** Cache the latest temporal report (`temporal:latest`) plus a dated history copy. */
+    setTemporalReport(report: unknown, date?: string): Promise<void>;
+    /** The cached latest temporal report, or null when absent/unparseable. */
+    getTemporalReport<T = unknown>(): Promise<T | null>;
 }
 
 /**
@@ -442,4 +236,4 @@ declare function htmlToText(html: string, maxChars?: number): string;
 /** Fetch a URL and return readable text. Best-effort: returns "" on any failure. */
 declare function fetchText(url: string, maxChars?: number): Promise<string>;
 
-export { type AttrSpec, type AttrType, COMMIT_STEP_CONFIG, type ConnectorContext, type ConnectorJob, type ContextConfig, type EdgeSpec, type EntitySpec, type ExtractCall, type ExtractResult, type GraphEdge, type GraphFragment, type GraphNode, IO_STEP_CONFIG, type KVLike, LLM_STEP_CONFIG, type LlmConfig, type LlmEnv, MODEL_TIERS, type MergeRule, type NaturalKeys, type Ontology, type PipelineDeps, type Provider, type ProviderFamily, type RawItem, type SearchCall, type SourceConnector, type SourceEntry, type StepConfig, type StepLike, Store, type Usage, type WriteCall, addUsage, allJobs, asStepLike, canonicalizeFragment, connectorIds, createProvider, emptyUsage, enabledSources, extractJson, extractJsonArray, fetchText, fetchUrl, fragmentToOps, getConnector, getProvider, htmlToText, humanAttrsOf, ingestFresh, isLikelyPersonName, jobsForHour, makeContext, mergeAttrs, mergeRulesOf, mergeScalar, naturalKeysOf, normalizeUrl, resilientStep, resolveName, searchEntities, slugify, toSerializedSchema, urlHash, writeFragment };
+export { COMMIT_STEP_CONFIG, ConnectorContext, type ContextConfig, type ExportEntitySpec, type ExportSpec, ExtractResult, GraphFragment, IO_STEP_CONFIG, type KVLike, LLM_STEP_CONFIG, MergeRule, Ontology, type PipelineDeps, Provider, RawItem, SourceConnector, SourceEntry, type StepConfig, type StepLike, Store, asStepLike, canonicalizeFragment, connectorIds, exportFragment, extractJson, extractJsonArray, fetchText, fetchUrl, getConnector, htmlToText, ingestFresh, isLikelyPersonName, makeContext, mergeAttrs, mergeScalar, normalizeUrl, resilientStep, resolveName, searchEntities, slugify, urlHash };

package/dist/index.d.ts

@@ -1,123 +1,47 @@
-import { Value, Op, AdminDb, SerializedAttr, Cardinality, SerializedSchema, Entity } from '@odla-ai/db';
-import { Ai } from '@odla-ai/ai';
-
-/**
- * The output of a connector: one acquired item. Exactly one of `text` or
- * `fragment` is set — `text` goes through LLM extraction, `fragment` is already
- * ontology-typed and goes straight to the graph writer (structured feeds).
- */
-interface RawItem {
-    url: string;
-    title: string;
-    date?: string;
-    sourceName: string;
-    sourceKind: string;
-    watch?: string | null;
-    text?: string;
-    fragment?: GraphFragment;
-}
-/** A graph node = an odla-db entity in a namespace, keyed by a natural key. */
-interface GraphNode {
-    type: string;
-    key: string;
-    attrs: Record<string, Value>;
-}
-/** A graph edge = an odla-db `link` from one node to another by forward label. */
-interface GraphEdge {
-    from: {
-        type: string;
-        key: string;
+import { O as Ontology, G as GraphFragment, M as MergeRule, P as Provider, S as SourceConnector, C as ConnectorContext, R as RawItem, a as SourceEntry, E as ExtractResult } from './sources-nJyD0JUP.js';
+export { A as AttrSpec, b as AttrType, c as ConnectorJob, d as EdgeSpec, e as EntitySpec, f as ExtractCall, g as GraphEdge, h as GraphNode, L as LlmConfig, i as LlmEnv, j as MODEL_TIERS, N as NaturalKeys, k as ProviderFamily, l as SearchCall, U as Usage, W as WriteCall, m as addUsage, n as allJobs, o as createProvider, p as emptyUsage, q as enabledSources, r as fragmentToOps, s as getProvider, t as humanAttrsOf, u as jobsForHour, v as mergeRulesOf, w as naturalKeysOf, x as toSerializedSchema, y as writeFragment } from './sources-nJyD0JUP.js';
+import { AdminDb, Value, Entity } from '@odla-ai/db';
+import '@odla-ai/ai';
+
+/** One entity type to export. */
+interface ExportEntitySpec {
+    /** Link labels (forward or reverse, as queried in InstaQL) to pull as nested rows. */
+    links?: readonly string[];
+    /** Attr allowlist kept on nodes. Default: every scalar attr except `id` and links. */
+    attrs?: readonly string[];
+    /**
+     * Date window. Filtering is client-side by default; set `indexed: true`
+     * (only when the attr really is indexed) to also push a
+     * `where { [dateAttr]: { $gte: from } }` to the server — odla-db silently
+     * returns zero rows for `where` on unindexed attrs.
+     */
+    window?: {
+        dateAttr: string;
+        from: string;
+        indexed?: boolean;
     };
-    to: {
-        type: string;
-        key: string;
-    };
-    label: string;
-}
-/** The single shape the graph writer consumes, whatever produced it. */
-interface GraphFragment {
-    nodes: GraphNode[];
-    edges: GraphEdge[];
-}
-/** What an extractor turns a text RawItem into: a fragment plus a prose summary. */
-interface ExtractResult {
-    fragment: GraphFragment;
-    summary: string;
+    /** Row cap for this type across the offset walk. Default 1000. */
+    limit?: number;
 }
-/** Provider-agnostic LLM usage accounting. */
-interface Usage {
-    calls: number;
-    inputTokens: number;
-    outputTokens: number;
+/** What {@link exportFragment} should read. */
+interface ExportSpec {
+    entities: Record<string, ExportEntitySpec>;
+    /** Rows per page in the offset walk (1–1000). Default 200. */
+    pageSize?: number;
 }
-/** Create zeroed provider-agnostic usage totals for one pipeline run. */
-declare function emptyUsage(): Usage;
-/** Mutate an accumulator by adding call, input-token, and output-token totals. */
-declare function addUsage(into: Usage, more: Usage): void;
-
-/** node type → unique natural-key attribute name. */
-type NaturalKeys = Record<string, string>;
 /**
- * Pure fragment → ops mapping (no read/merge). Node upserts by Lookup natural
- * key, then links — nodes always before links so `link` targets resolve.
- * Used by tests and as the building block for the provenance path below.
+ * Export (a window of) the graph as a `GraphFragment` — nodes and forward
+ * edges — ready for `extractEvents` and the rest of `@odla-ai/kg/temporal`.
+ *
+ * Each entity type is read with a stable offset walk (ordered by its natural
+ * key) carrying its requested link labels as nested relations. Date windows
+ * filter client-side; for attrs declared `indexed` the filter also runs
+ * server-side, and if that indexed filter ever exceeds the scan budget
+ * (`query_scan_limit`) the walk restarts without `where`.
+ * Nodes dedupe by `type:key` keeping the richer attr set; output ordering is
+ * deterministic (nodes by type/key, edges by from/label/to).
  */
-declare function fragmentToOps(fragment: GraphFragment, keys: NaturalKeys): Op[];
-/**
- * Provenance-preserving write. Reads existing nodes by natural key (one batched
- * query), merges scalar attrs per the ontology's rules, drops human-owned
- * attrs, then writes merged node updates + all links in one atomic, idempotent
- * transaction. `mutationId` must be deterministic so odla-db can deduplicate
- * the write on retry; this does not make preceding reads or external effects
- * exactly-once.
- */
-declare function writeFragment(db: AdminDb, fragment: GraphFragment, ontology: Ontology, mutationId: string): Promise<{
-    txId: number;
-    ops: number;
-}>;
-
-/** How a scalar attribute is reconciled when a node is re-discovered. */
-type MergeRule = "replace" | "prefer" | "earliest" | "latest";
-type AttrType = SerializedAttr["type"];
-interface AttrSpec {
-    type: AttrType;
-    unique?: boolean;
-    indexed?: boolean;
-    optional?: boolean;
-    /** The pipeline NEVER writes this attr (hand-edited in a UI); omitted from every update. */
-    human?: boolean;
-    /** Provenance rule for re-discovery. Default "replace". */
-    merge?: MergeRule;
-    /** Shown to the LLM when this attr appears in an extraction schema. */
-    desc?: string;
-}
-interface EntitySpec {
-    /** Unique attr used for Lookup upsert (MERGE key). Must be `unique` in attrs. */
-    naturalKey: string;
-    attrs: Record<string, AttrSpec>;
-    /** FTS fields for fuzzy resolution (P5). */
-    searchable?: string[];
-}
-interface EdgeSpec {
-    from: string;
-    to: string;
-    forwardLabel: string;
-    reverseLabel: string;
-    forwardHas?: Cardinality;
-    reverseHas?: Cardinality;
-}
-interface Ontology {
-    entities: Record<string, EntitySpec>;
-    edges: Record<string, EdgeSpec>;
-}
-/** node type → natural-key attr name (for the graph writer's Lookup refs). */
-declare function naturalKeysOf(o: Ontology): NaturalKeys;
-/** Attr name → merge rule, for every entity type (used by the provenance writer). */
-declare function mergeRulesOf(o: Ontology): Record<string, Record<string, MergeRule>>;
-/** Attr names the pipeline must never write, per entity type. */
-declare function humanAttrsOf(o: Ontology): Record<string, Set<string>>;
-/** Compile the ontology to an odla-db SerializedSchema to POST at /app/:id/schema. */
-declare function toSerializedSchema(o: Ontology): SerializedSchema;
+declare function exportFragment(db: AdminDb, ontology: Ontology, spec: ExportSpec): Promise<GraphFragment>;
 
 /**
  * Reconcile one scalar attribute when a node is re-discovered. Port of agnacl's
@@ -147,83 +71,6 @@ declare function resolveName(db: AdminDb, type: string, keyAttr: string, name: s
  */
 declare function canonicalizeFragment(db: AdminDb, fragment: GraphFragment, ontology: Ontology): Promise<GraphFragment>;
 
-/**
- * The LLM seam, now a thin adapter over @odla-ai/ai (which was itself
- * generalized from this package's original Provider). Three verbs stay:
- * extract (forced structured tool call), search (web-search-enabled text),
- * write (plain generation). Callers never see vendor or oracle types.
- */
-type ProviderFamily = "claude" | "openai";
-/** Role → model tiers per family — config as data. `cheap` is for gate-style
- * calls, `extract` for structured extraction (and prose writing), `search`
- * for web-search-enabled calls. */
-declare const MODEL_TIERS: Record<ProviderFamily, {
-    cheap: string;
-    extract: string;
-    search: string;
-}>;
-/** A forced structured tool call: schema in, validated object out. */
-interface ExtractCall {
-    system: string;
-    user: string;
-    tool: {
-        name: string;
-        description?: string;
-        parameters: Record<string, unknown>;
-    };
-    model?: string;
-    maxTokens?: number;
-}
-/** A web-search-enabled call: the model searches and returns text (caller tolerant-parses). */
-interface SearchCall {
-    system: string;
-    user: string;
-    model?: string;
-    maxTokens?: number;
-}
-/** A plain text-generation call (no tools, no search) — e.g. digest prose. */
-interface WriteCall {
-    system: string;
-    user: string;
-    model?: string;
-    maxTokens?: number;
-}
-interface Provider {
-    id: ProviderFamily;
-    /** The underlying @odla-ai/ai client — escape hatch for advanced use. */
-    ai: Ai;
-    extract<T = unknown>(c: ExtractCall): Promise<{
-        value: T;
-        usage: Usage;
-    }>;
-    search(c: SearchCall): Promise<{
-        text: string;
-        usage: Usage;
-    }>;
-    write(c: WriteCall): Promise<{
-        text: string;
-        usage: Usage;
-    }>;
-}
-interface LlmConfig {
-    provider: ProviderFamily;
-    anthropicKey?: string;
-    openaiKey?: string;
-    /** Inject a pre-built Ai (tests, custom catalog); keys are ignored when set. */
-    ai?: Ai;
-}
-/** The library primitive: an explicit config in, the three-verb seam out. */
-declare function createProvider(cfg: LlmConfig): Provider;
-/** The env vars the provider factory reads — a structural slice, not the
- * worker Env, so any host (worker, script, test) can supply plain strings. */
-interface LlmEnv {
-    LLM_PROVIDER?: string;
-    ANTHROPIC_API_KEY?: string;
-    OPENAI_API_KEY?: string;
-}
-/** Build the configured provider from host env, failing before use when its key is missing. */
-declare function getProvider(env: LlmEnv): Provider;
-
 /**
  * Tolerant JSON extraction from LLM prose — web-search models return JSON inside
  * explanatory text. Ported from agnacl services/enrichment.ts.
@@ -232,41 +79,6 @@ declare function extractJson<T = unknown>(text: string): T | null;
 /** Tolerantly parse the first JSON-array-shaped span in model prose, or return an empty array. */
 declare function extractJsonArray<T = unknown>(text: string): T[];
 
-/** Ambient services a connector may use. Host-agnostic: secrets come through
- * secret(), never a worker Env, so the library runs anywhere. */
-interface ConnectorContext {
-    now: Date;
-    fetchText(url: string): Promise<string>;
-    secret(name: string): string | undefined;
-    ontology: Ontology;
-    /** The configured LLM provider (lazy — only web-search/discovery connectors need it). */
-    provider(): Provider;
-}
-/**
- * The extensibility seam. A connector emits normalized RawItems — text-bearing
- * (→ LLM extraction) or fragment-bearing (structured → straight to the writer).
- * Adding a source = a new module implementing this + one registry line.
- */
-interface SourceConnector<Cfg = unknown> {
-    id: string;
-    capabilities: {
-        fetch: boolean;
-        discover?: boolean;
-        structured: boolean;
-    };
-    parseConfig(raw: unknown): Cfg;
-    fetch(cfg: Cfg, ctx: ConnectorContext): Promise<RawItem[]>;
-    /** Web-search-style net-new discovery (P4). */
-    discover?(cfg: Cfg, ctx: ConnectorContext): Promise<RawItem[]>;
-}
-/** One unit of work for the ingest workflow: which connector + its config. */
-interface ConnectorJob {
-    kind: string;
-    name: string;
-    watch?: string | null;
-    cfg: unknown;
-}
-
 /** Resolve a built-in source connector by its stable registry id. */
 declare function getConnector(id: string): SourceConnector | undefined;
 /** List registered connector ids in deterministic insertion order. */
@@ -285,28 +97,6 @@ declare function makeContext(cfg: ContextConfig): ConnectorContext;
 /** Fetch one URL → a text-bearing RawItem. Used both directly (/trigger) and as a connector. */
 declare function fetchUrl(url: string): Promise<RawItem>;
 
-/**
- * Sources are DATA, not code. Each entry names a connector (`kind`) + its config
- * + scheduling. Add a feed → add an entry; no redeploy of the pipeline. P5 moves
- * this into KV behind a /config admin endpoint so edits don't need a deploy at all.
- */
-interface SourceEntry {
-    kind: string;
-    name: string;
-    enabled?: boolean;
-    cadenceHours?: number;
-    watch?: string | null;
-    url?: string;
-    query?: string;
-    [key: string]: unknown;
-}
-/** Return source entries not explicitly disabled, preserving configured order. */
-declare function enabledSources(sources: SourceEntry[]): SourceEntry[];
-/** Enabled sources whose cadence lands on this UTC hour. */
-declare function jobsForHour(sources: SourceEntry[], hour: number): ConnectorJob[];
-/** Every enabled source, ignoring cadence (manual /trigger?kind=sources). */
-declare function allJobs(sources: SourceEntry[]): ConnectorJob[];
-
 /**
  * The slice of a KV store the pipeline needs. Cloudflare's KVNamespace
  * satisfies it structurally; tests pass an in-memory map. Keeping the library
@@ -338,6 +128,10 @@ declare class Store {
     /** Runtime source config (edit without redeploy). null = fall back to the static SOURCES. */
     getConfigSources(): Promise<SourceEntry[] | null>;
     setConfigSources(list: SourceEntry[]): Promise<void>;
+    /** Cache the latest temporal report (`temporal:latest`) plus a dated history copy. */
+    setTemporalReport(report: unknown, date?: string): Promise<void>;
+    /** The cached latest temporal report, or null when absent/unparseable. */
+    getTemporalReport<T = unknown>(): Promise<T | null>;
 }
 
 /**
@@ -442,4 +236,4 @@ declare function htmlToText(html: string, maxChars?: number): string;
 /** Fetch a URL and return readable text. Best-effort: returns "" on any failure. */
 declare function fetchText(url: string, maxChars?: number): Promise<string>;
 
-export { type AttrSpec, type AttrType, COMMIT_STEP_CONFIG, type ConnectorContext, type ConnectorJob, type ContextConfig, type EdgeSpec, type EntitySpec, type ExtractCall, type ExtractResult, type GraphEdge, type GraphFragment, type GraphNode, IO_STEP_CONFIG, type KVLike, LLM_STEP_CONFIG, type LlmConfig, type LlmEnv, MODEL_TIERS, type MergeRule, type NaturalKeys, type Ontology, type PipelineDeps, type Provider, type ProviderFamily, type RawItem, type SearchCall, type SourceConnector, type SourceEntry, type StepConfig, type StepLike, Store, type Usage, type WriteCall, addUsage, allJobs, asStepLike, canonicalizeFragment, connectorIds, createProvider, emptyUsage, enabledSources, extractJson, extractJsonArray, fetchText, fetchUrl, fragmentToOps, getConnector, getProvider, htmlToText, humanAttrsOf, ingestFresh, isLikelyPersonName, jobsForHour, makeContext, mergeAttrs, mergeRulesOf, mergeScalar, naturalKeysOf, normalizeUrl, resilientStep, resolveName, searchEntities, slugify, toSerializedSchema, urlHash, writeFragment };
+export { COMMIT_STEP_CONFIG, ConnectorContext, type ContextConfig, type ExportEntitySpec, type ExportSpec, ExtractResult, GraphFragment, IO_STEP_CONFIG, type KVLike, LLM_STEP_CONFIG, MergeRule, Ontology, type PipelineDeps, Provider, RawItem, SourceConnector, SourceEntry, type StepConfig, type StepLike, Store, asStepLike, canonicalizeFragment, connectorIds, exportFragment, extractJson, extractJsonArray, fetchText, fetchUrl, getConnector, htmlToText, ingestFresh, isLikelyPersonName, makeContext, mergeAttrs, mergeScalar, normalizeUrl, resilientStep, resolveName, searchEntities, slugify, urlHash };