memorysync-sdk 1.1.0 → 1.2.0

package/dist/index.d.mts

@@ -161,6 +161,7 @@ interface AuditEventQuery {
     source?: string;
     ingestMethod?: string;
     search?: string;
+    includeStats?: boolean;
 }
 interface AuditActor {
     id: string;
@@ -545,6 +546,139 @@ interface ExportResponse {
     generatedAt: string;
 }
 
+/** One edit inside a {@link MemorySyncClient.batchUpdate} call. */
+interface BatchUpdateItem {
+    memoryId: number;
+    tags?: string[];
+    importance?: number;
+    metadata?: Record<string, unknown>;
+    source?: string;
+    eventType?: string;
+}
+interface BatchUpdateItemResult {
+    index: number;
+    memoryId: number;
+    status: "updated" | "not_found";
+    changedFields: string[];
+}
+/**
+ * Result of a batch update.
+ *
+ * The server answers `207 Multi-Status`: a batch may legitimately name a memory
+ * the caller cannot see, and the caller needs to know which one rather than
+ * losing the whole request. `notFound` is an ordinary outcome, not an error.
+ */
+interface BatchUpdateResponse {
+    total: number;
+    updated: number;
+    notFound: number;
+    results: BatchUpdateItemResult[];
+}
+/**
+ * Criteria for a filter-based delete.
+ *
+ * At least one field must be set — an all-empty filter would mean "delete
+ * everything I own", which has to be an explicit `purgeUser()` call instead.
+ * `tags` matches memories carrying **all** the listed tags, not any of them.
+ */
+interface ForgetFilters {
+    source?: string;
+    eventType?: string;
+    tags?: string[];
+    tier?: string;
+    before?: string;
+    after?: string;
+}
+interface ForgetRequest {
+    memoryIds?: number[];
+    filters?: ForgetFilters;
+    /** Return the ids that *would* be deleted without deleting anything. */
+    dryRun?: boolean;
+    reason?: string;
+}
+type RevisionEvent = "created" | "updated" | "superseded" | "soft_deleted" | "restored" | "archived" | "purged";
+/**
+ * One recorded change to a memory.
+ *
+ * Revision 0 is the creation entry, synthesised by the server. `actor` is `null`
+ * for changes made by background workers, which have no request behind them —
+ * that is expected rather than missing data.
+ */
+interface RevisionEntry {
+    revision: number;
+    event: RevisionEvent;
+    changedFields: string[];
+    diff: Record<string, {
+        old?: unknown;
+        new?: unknown;
+    }>;
+    actor: string | null;
+    createdAt: string;
+}
+interface HistoryResponse {
+    memoryId: number;
+    total: number;
+    revisions: RevisionEntry[];
+    /**
+     * The fields changes are recorded for. Worth reading: only user-meaningful
+     * fields are tracked, so without this you cannot tell "nothing changed" from
+     * "that change is not recorded".
+     */
+    trackedFields: string[];
+}
+type FeedbackSignal = "positive" | "negative" | "retrieved" | "ignored";
+interface FeedbackTrend {
+    momentum: string;
+    consistency: number;
+    trendMultiplier: number;
+    recentCount: number;
+}
+interface FeedbackSummary {
+    totalSignals: number;
+    signalCounts: Record<string, number>;
+    trend: FeedbackTrend;
+}
+interface FeedbackResponse {
+    memoryId: number;
+    signal: FeedbackSignal;
+    importanceBefore: number;
+    importanceAfter: number;
+    /** Delta actually applied. `0` when ranking influence is off, or when the change was clamped at the bounds. */
+    adjustment: number;
+    /** Whether this signal was allowed to change ranking. Reported, not assumed. */
+    influencedRanking: boolean;
+    summary: FeedbackSummary;
+}
+/**
+ * The memory vocabulary in effect for an organization.
+ *
+ * The built-in types are a floor: they always apply and cannot be removed,
+ * because dropping a type would leave memories already filed under it invisible
+ * to any typed retrieval. Only `custom*` entries are removable.
+ */
+interface Ontology {
+    contentTypes: string[];
+    relationTypes: string[];
+    builtinContentTypes: string[];
+    builtinRelationTypes: string[];
+    customContentTypes: string[];
+    customRelationTypes: string[];
+    maxCustomTypes: number;
+}
+interface OntologyUpdateRequest {
+    contentTypes?: string[];
+    relationTypes?: string[];
+}
+interface UploadRequest {
+    /** File contents. A `Blob`/`File` in browsers and Node 18+, or a `Uint8Array`. */
+    file: Blob | Uint8Array;
+    /** Required: the server picks its parser from the extension. */
+    filename: string;
+    contentType?: string;
+    source?: string;
+    metadata?: Record<string, unknown>;
+    endUserId?: string;
+}
 declare class MemorySyncClient {
     private readonly apiKey;
     private readonly baseUrl;
@@ -563,11 +697,179 @@ declare class MemorySyncClient {
     query(req: QueryRequest): Promise<QueryResponse>;
     get(memoryId: number): Promise<MemoryRecord>;
     update(memoryId: number, req: UpdateRequest): Promise<MemoryRecord>;
+    /**
+     * Delete memories, either by id or by filter. Returns the deleted ids.
+     *
+     * Accepts the legacy positional form `forget([1,2], "reason")` as well as
+     * `forget({ filters, dryRun })`. The positional form is kept because it ships
+     * in 1.1.x and removing it would break installed callers for no benefit.
+     *
+     * Exactly one selector. Passing both is rejected rather than resolved by a
+     * precedence rule, because getting that wrong on a delete cannot be undone.
+     * Deletion is scoped to the calling end user, so a filter never reaches
+     * another end user's memories — including the organisation's connector history.
+     */
+    forget(request: ForgetRequest): Promise<number[]>;
     forget(memoryIds: number[], reason?: string): Promise<number[]>;
+    /**
+     * Delete every memory belonging to the calling end user.
+     *
+     * Separate from {@link forget} on purpose: this reads like what it does, so a
+     * whole-namespace delete can never be the accidental result of an empty filter.
+     */
+    purgeUser(): Promise<Record<string, unknown>>;
     summarize(req: SummarizeRequest): Promise<MemoryRecord>;
     compose(req: ComposeRequest): Promise<ComposeResponse>;
     exportAll(): Promise<ExportResponse>;
     createRelation(fromMemoryId: number, req: RelationCreateRequest): Promise<RelationRecord>;
+    /**
+     * Ingest a document and store the memories extracted from its text.
+     *
+     * Accepts the formats the connectors accept — PDF, DOCX, PPTX, XLSX, CSV,
+     * text, Markdown, HTML, source code, and images/audio/video where
+     * transcription is configured.
+     *
+     * Billed as an add, one unit per memory created. Resolves to the first stored
+     * memory, or an {@link AddSkippedResponse} when the file yielded nothing worth
+     * keeping — a blank scan, a sheet of empty cells, or content the extractor
+     * judges trivial are all normal outcomes rather than errors.
+     */
+    upload(req: UploadRequest): Promise<AddResponse>;
+    /**
+     * Apply many metadata edits in one request.
+     *
+     * Editable: `tags`, `importance`, `metadata`, `source`, `eventType`. A memory's
+     * text, embeddings, owner, environment and project are not editable.
+     *
+     * Applied in one transaction, so the batch either lands or it does not — but an
+     * id the caller cannot see is reported per item rather than failing the request.
+     */
+    batchUpdate(items: BatchUpdateItem[]): Promise<BatchUpdateResponse>;
+    /**
+     * Recorded changes to one memory, oldest first.
+     *
+     * Entry 0 is the creation. Later entries carry the old and new value per field.
+     * Entries written by background workers have `actor: null`. Only
+     * user-meaningful fields are tracked; the watched list comes back in
+     * `trackedFields`.
+     */
+    history(memoryId: number, opts?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<HistoryResponse>;
+    /**
+     * Tell MemorySync whether a memory was useful.
+     *
+     * By default this moves the memory's `importance`, a weighted retrieval-ranking
+     * factor, so a memory marked useful surfaces more readily and one marked wrong
+     * surfaces less. The size of the move is adaptive: consistent signals amplify
+     * it, mixed signals damp it. Importance is clamped to [0.05, 1.0], so no run of
+     * negative feedback can make a memory permanently unreachable. Not billed.
+     */
+    feedback(memoryId: number, signal: FeedbackSignal, opts?: {
+        comment?: string;
+    }): Promise<FeedbackResponse>;
+    /** The memory vocabulary in effect for this organization. */
+    getOntology(): Promise<Ontology>;
+    /**
+     * Replace this organization's *additions* to the vocabulary.
+     *
+     * The two vocabularies are independent: omit one and it is left untouched, so
+     * adding a content type cannot wipe your relation types. Pass an empty array to
+     * clear a vocabulary's custom entries. The built-in types always remain.
+     */
+    updateOntology(req: OntologyUpdateRequest): Promise<Ontology>;
+    /**
+     * Alias of {@link query} against `/memory/retrieve`.
+     *
+     * Both paths are live, and integrators arriving from other platforms reach for
+     * `retrieve`. Identical semantics.
+     */
+    retrieve(req: QueryRequest): Promise<QueryResponse>;
+    /**
+     * Route a question to the best knowledge source and answer from it.
+     *
+     * Returns the raw payload: the response carries routing diagnostics whose shape
+     * is richer and more volatile than an SDK should freeze into an interface.
+     */
+    searchRouted(query: string, opts?: {
+        k?: number;
+        route?: string;
+        includeReasoning?: boolean;
+    }): Promise<Record<string, unknown>>;
+    /** Compose an answer across several memories, with citations. */
+    synthesize(opts?: {
+        query?: string;
+        memoryIds?: number[];
+        maxMemories?: number;
+    }): Promise<Record<string, unknown>>;
+    /** Re-embed this end user's memories. Returns immediately (`202`). */
+    refresh(): Promise<Record<string, unknown>>;
+    /** Nodes and typed edges for this end user's memory graph. */
+    graph(opts?: {
+        limit?: number;
+        memoryId?: number;
+        depth?: number;
+    }): Promise<Record<string, unknown>>;
+    /** Semantic clusters over this end user's memories. */
+    clusters(opts?: {
+        limit?: number;
+    }): Promise<Record<string, unknown>>;
+    /** Contradictions and open decisions detected across memories. */
+    decisions(opts?: {
+        limit?: number;
+    }): Promise<Record<string, unknown>>;
+    /** Record which side of a contradiction wins. */
+    resolveDecision(opts?: {
+        decisionId?: string;
+        winningMemoryId?: number;
+        resolution?: string;
+        note?: string;
+    }): Promise<Record<string, unknown>>;
+    /**
+     * The intelligence report: themes, entities, patterns, dual-horizon view.
+     *
+     * `scope` is explicit by design server-side — nothing is inferred, so if you do
+     * not ask for a scope you do not get it.
+     */
+    intelligence(opts?: {
+        limit?: number;
+        scope?: string;
+        projectId?: string;
+    }): Promise<Record<string, unknown>>;
+    /** Counts and coverage for the knowledge base. */
+    knowledgeStats(): Promise<Record<string, unknown>>;
+    /** Add a conversation turn and extract memories from it. */
+    addTurn(req: {
+        tenantId: string;
+        userId: string;
+        messages: Array<Record<string, unknown>>;
+        sessionId?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<Record<string, unknown>>;
+    /**
+     * Build a prompt-ready context block for an LLM call.
+     *
+     * `types` narrows the result to those content types. Names outside the
+     * organization's vocabulary are dropped rather than rejected, so a stale client
+     * gets a narrower answer instead of an error.
+     */
+    recall(req: {
+        tenantId: string;
+        userId: string;
+        prompt: string;
+        k?: number;
+        types?: string[];
+    }): Promise<Record<string, unknown>>;
+    /** Async ingestion status for one memory. */
+    status(memoryId: number): Promise<Record<string, unknown>>;
+    /** Page through a specific end user's memories. */
+    listMemories(req: {
+        tenantId: string;
+        userId: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<Record<string, unknown>>;
 }
 
-export { type AddRequest, type AddResponse, type AddSkippedResponse, type ApiKeyTestResponse, type ApiKeyTestStatus, type AuditActor, type AuditEvent, type AuditEventListResponse, type AuditEventQuery, type AuditResource, type AuditSortDirection, AuthError, type BulkAddItem, type BulkAddItemResult, type BulkAddResponse, type BulkRevokeApiKeyResult, type BulkRevokeApiKeysRequest, type BulkRevokeApiKeysResponse, type ComposeRequest, type ComposeResponse, ControlPlaneClient, type ControlPlaneConfig, type ControlPlaneRequestOptions, type CreateOrganizationRequest, type CreateWebhookRequest, type CreatedWebhook, type CurrentPlanResponse, type ExportResponse, type Integration, type IntegrationQuery, type LoginRequest, type LoginResponse, type MemoryRecord, MemorySyncClient, type MemorySyncConfig, MemorySyncError, NotFoundError, type OrganizationMembership, type OrganizationSettings, type OrganizationSettingsQuery, type Plan, type PlanLimits, type Project, type QueryFilters, type QueryRequest, type QueryResponse, RateLimitError, type RelationCreateRequest, type RelationRecord, type RelationshipType, type ReplayWebhookDeliveriesRequest, type ReplayWebhookDeliveriesResponse, ServerError, type Session, type SessionListResponse, type SummarizeRequest, type TeamMember, type TestWebhookRequest, type TestWebhookResponse, type UpdateRequest, type UpdateWebhookRequest, ValidationError, type Webhook, type WebhookDelivery, type WebhookDeliveryListResponse, type WebhookDeliveryQuery, type WebhookListResponse, type WebhookRetryConfig, type WebhookSignatureConfig };
+export { type AddRequest, type AddResponse, type AddSkippedResponse, type ApiKeyTestResponse, type ApiKeyTestStatus, type AuditActor, type AuditEvent, type AuditEventListResponse, type AuditEventQuery, type AuditResource, type AuditSortDirection, AuthError, type BatchUpdateItem, type BatchUpdateItemResult, type BatchUpdateResponse, type BulkAddItem, type BulkAddItemResult, type BulkAddResponse, type BulkRevokeApiKeyResult, type BulkRevokeApiKeysRequest, type BulkRevokeApiKeysResponse, type ComposeRequest, type ComposeResponse, ControlPlaneClient, type ControlPlaneConfig, type ControlPlaneRequestOptions, type CreateOrganizationRequest, type CreateWebhookRequest, type CreatedWebhook, type CurrentPlanResponse, type ExportResponse, type FeedbackResponse, type FeedbackSignal, type FeedbackSummary, type FeedbackTrend, type ForgetFilters, type ForgetRequest, type HistoryResponse, type Integration, type IntegrationQuery, type LoginRequest, type LoginResponse, type MemoryRecord, MemorySyncClient, type MemorySyncConfig, MemorySyncError, NotFoundError, type Ontology, type OntologyUpdateRequest, type OrganizationMembership, type OrganizationSettings, type OrganizationSettingsQuery, type Plan, type PlanLimits, type Project, type QueryFilters, type QueryRequest, type QueryResponse, RateLimitError, type RelationCreateRequest, type RelationRecord, type RelationshipType, type ReplayWebhookDeliveriesRequest, type ReplayWebhookDeliveriesResponse, type RevisionEntry, type RevisionEvent, ServerError, type Session, type SessionListResponse, type SummarizeRequest, type TeamMember, type TestWebhookRequest, type TestWebhookResponse, type UpdateRequest, type UpdateWebhookRequest, type UploadRequest, ValidationError, type Webhook, type WebhookDelivery, type WebhookDeliveryListResponse, type WebhookDeliveryQuery, type WebhookListResponse, type WebhookRetryConfig, type WebhookSignatureConfig };

package/dist/index.d.ts

@@ -161,6 +161,7 @@ interface AuditEventQuery {
     source?: string;
     ingestMethod?: string;
     search?: string;
+    includeStats?: boolean;
 }
 interface AuditActor {
     id: string;
@@ -545,6 +546,139 @@ interface ExportResponse {
     generatedAt: string;
 }
 
+/** One edit inside a {@link MemorySyncClient.batchUpdate} call. */
+interface BatchUpdateItem {
+    memoryId: number;
+    tags?: string[];
+    importance?: number;
+    metadata?: Record<string, unknown>;
+    source?: string;
+    eventType?: string;
+}
+interface BatchUpdateItemResult {
+    index: number;
+    memoryId: number;
+    status: "updated" | "not_found";
+    changedFields: string[];
+}
+/**
+ * Result of a batch update.
+ *
+ * The server answers `207 Multi-Status`: a batch may legitimately name a memory
+ * the caller cannot see, and the caller needs to know which one rather than
+ * losing the whole request. `notFound` is an ordinary outcome, not an error.
+ */
+interface BatchUpdateResponse {
+    total: number;
+    updated: number;
+    notFound: number;
+    results: BatchUpdateItemResult[];
+}
+/**
+ * Criteria for a filter-based delete.
+ *
+ * At least one field must be set — an all-empty filter would mean "delete
+ * everything I own", which has to be an explicit `purgeUser()` call instead.
+ * `tags` matches memories carrying **all** the listed tags, not any of them.
+ */
+interface ForgetFilters {
+    source?: string;
+    eventType?: string;
+    tags?: string[];
+    tier?: string;
+    before?: string;
+    after?: string;
+}
+interface ForgetRequest {
+    memoryIds?: number[];
+    filters?: ForgetFilters;
+    /** Return the ids that *would* be deleted without deleting anything. */
+    dryRun?: boolean;
+    reason?: string;
+}
+type RevisionEvent = "created" | "updated" | "superseded" | "soft_deleted" | "restored" | "archived" | "purged";
+/**
+ * One recorded change to a memory.
+ *
+ * Revision 0 is the creation entry, synthesised by the server. `actor` is `null`
+ * for changes made by background workers, which have no request behind them —
+ * that is expected rather than missing data.
+ */
+interface RevisionEntry {
+    revision: number;
+    event: RevisionEvent;
+    changedFields: string[];
+    diff: Record<string, {
+        old?: unknown;
+        new?: unknown;
+    }>;
+    actor: string | null;
+    createdAt: string;
+}
+interface HistoryResponse {
+    memoryId: number;
+    total: number;
+    revisions: RevisionEntry[];
+    /**
+     * The fields changes are recorded for. Worth reading: only user-meaningful
+     * fields are tracked, so without this you cannot tell "nothing changed" from
+     * "that change is not recorded".
+     */
+    trackedFields: string[];
+}
+type FeedbackSignal = "positive" | "negative" | "retrieved" | "ignored";
+interface FeedbackTrend {
+    momentum: string;
+    consistency: number;
+    trendMultiplier: number;
+    recentCount: number;
+}
+interface FeedbackSummary {
+    totalSignals: number;
+    signalCounts: Record<string, number>;
+    trend: FeedbackTrend;
+}
+interface FeedbackResponse {
+    memoryId: number;
+    signal: FeedbackSignal;
+    importanceBefore: number;
+    importanceAfter: number;
+    /** Delta actually applied. `0` when ranking influence is off, or when the change was clamped at the bounds. */
+    adjustment: number;
+    /** Whether this signal was allowed to change ranking. Reported, not assumed. */
+    influencedRanking: boolean;
+    summary: FeedbackSummary;
+}
+/**
+ * The memory vocabulary in effect for an organization.
+ *
+ * The built-in types are a floor: they always apply and cannot be removed,
+ * because dropping a type would leave memories already filed under it invisible
+ * to any typed retrieval. Only `custom*` entries are removable.
+ */
+interface Ontology {
+    contentTypes: string[];
+    relationTypes: string[];
+    builtinContentTypes: string[];
+    builtinRelationTypes: string[];
+    customContentTypes: string[];
+    customRelationTypes: string[];
+    maxCustomTypes: number;
+}
+interface OntologyUpdateRequest {
+    contentTypes?: string[];
+    relationTypes?: string[];
+}
+interface UploadRequest {
+    /** File contents. A `Blob`/`File` in browsers and Node 18+, or a `Uint8Array`. */
+    file: Blob | Uint8Array;
+    /** Required: the server picks its parser from the extension. */
+    filename: string;
+    contentType?: string;
+    source?: string;
+    metadata?: Record<string, unknown>;
+    endUserId?: string;
+}
 declare class MemorySyncClient {
     private readonly apiKey;
     private readonly baseUrl;
@@ -563,11 +697,179 @@ declare class MemorySyncClient {
     query(req: QueryRequest): Promise<QueryResponse>;
     get(memoryId: number): Promise<MemoryRecord>;
     update(memoryId: number, req: UpdateRequest): Promise<MemoryRecord>;
+    /**
+     * Delete memories, either by id or by filter. Returns the deleted ids.
+     *
+     * Accepts the legacy positional form `forget([1,2], "reason")` as well as
+     * `forget({ filters, dryRun })`. The positional form is kept because it ships
+     * in 1.1.x and removing it would break installed callers for no benefit.
+     *
+     * Exactly one selector. Passing both is rejected rather than resolved by a
+     * precedence rule, because getting that wrong on a delete cannot be undone.
+     * Deletion is scoped to the calling end user, so a filter never reaches
+     * another end user's memories — including the organisation's connector history.
+     */
+    forget(request: ForgetRequest): Promise<number[]>;
     forget(memoryIds: number[], reason?: string): Promise<number[]>;
+    /**
+     * Delete every memory belonging to the calling end user.
+     *
+     * Separate from {@link forget} on purpose: this reads like what it does, so a
+     * whole-namespace delete can never be the accidental result of an empty filter.
+     */
+    purgeUser(): Promise<Record<string, unknown>>;
     summarize(req: SummarizeRequest): Promise<MemoryRecord>;
     compose(req: ComposeRequest): Promise<ComposeResponse>;
     exportAll(): Promise<ExportResponse>;
     createRelation(fromMemoryId: number, req: RelationCreateRequest): Promise<RelationRecord>;
+    /**
+     * Ingest a document and store the memories extracted from its text.
+     *
+     * Accepts the formats the connectors accept — PDF, DOCX, PPTX, XLSX, CSV,
+     * text, Markdown, HTML, source code, and images/audio/video where
+     * transcription is configured.
+     *
+     * Billed as an add, one unit per memory created. Resolves to the first stored
+     * memory, or an {@link AddSkippedResponse} when the file yielded nothing worth
+     * keeping — a blank scan, a sheet of empty cells, or content the extractor
+     * judges trivial are all normal outcomes rather than errors.
+     */
+    upload(req: UploadRequest): Promise<AddResponse>;
+    /**
+     * Apply many metadata edits in one request.
+     *
+     * Editable: `tags`, `importance`, `metadata`, `source`, `eventType`. A memory's
+     * text, embeddings, owner, environment and project are not editable.
+     *
+     * Applied in one transaction, so the batch either lands or it does not — but an
+     * id the caller cannot see is reported per item rather than failing the request.
+     */
+    batchUpdate(items: BatchUpdateItem[]): Promise<BatchUpdateResponse>;
+    /**
+     * Recorded changes to one memory, oldest first.
+     *
+     * Entry 0 is the creation. Later entries carry the old and new value per field.
+     * Entries written by background workers have `actor: null`. Only
+     * user-meaningful fields are tracked; the watched list comes back in
+     * `trackedFields`.
+     */
+    history(memoryId: number, opts?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<HistoryResponse>;
+    /**
+     * Tell MemorySync whether a memory was useful.
+     *
+     * By default this moves the memory's `importance`, a weighted retrieval-ranking
+     * factor, so a memory marked useful surfaces more readily and one marked wrong
+     * surfaces less. The size of the move is adaptive: consistent signals amplify
+     * it, mixed signals damp it. Importance is clamped to [0.05, 1.0], so no run of
+     * negative feedback can make a memory permanently unreachable. Not billed.
+     */
+    feedback(memoryId: number, signal: FeedbackSignal, opts?: {
+        comment?: string;
+    }): Promise<FeedbackResponse>;
+    /** The memory vocabulary in effect for this organization. */
+    getOntology(): Promise<Ontology>;
+    /**
+     * Replace this organization's *additions* to the vocabulary.
+     *
+     * The two vocabularies are independent: omit one and it is left untouched, so
+     * adding a content type cannot wipe your relation types. Pass an empty array to
+     * clear a vocabulary's custom entries. The built-in types always remain.
+     */
+    updateOntology(req: OntologyUpdateRequest): Promise<Ontology>;
+    /**
+     * Alias of {@link query} against `/memory/retrieve`.
+     *
+     * Both paths are live, and integrators arriving from other platforms reach for
+     * `retrieve`. Identical semantics.
+     */
+    retrieve(req: QueryRequest): Promise<QueryResponse>;
+    /**
+     * Route a question to the best knowledge source and answer from it.
+     *
+     * Returns the raw payload: the response carries routing diagnostics whose shape
+     * is richer and more volatile than an SDK should freeze into an interface.
+     */
+    searchRouted(query: string, opts?: {
+        k?: number;
+        route?: string;
+        includeReasoning?: boolean;
+    }): Promise<Record<string, unknown>>;
+    /** Compose an answer across several memories, with citations. */
+    synthesize(opts?: {
+        query?: string;
+        memoryIds?: number[];
+        maxMemories?: number;
+    }): Promise<Record<string, unknown>>;
+    /** Re-embed this end user's memories. Returns immediately (`202`). */
+    refresh(): Promise<Record<string, unknown>>;
+    /** Nodes and typed edges for this end user's memory graph. */
+    graph(opts?: {
+        limit?: number;
+        memoryId?: number;
+        depth?: number;
+    }): Promise<Record<string, unknown>>;
+    /** Semantic clusters over this end user's memories. */
+    clusters(opts?: {
+        limit?: number;
+    }): Promise<Record<string, unknown>>;
+    /** Contradictions and open decisions detected across memories. */
+    decisions(opts?: {
+        limit?: number;
+    }): Promise<Record<string, unknown>>;
+    /** Record which side of a contradiction wins. */
+    resolveDecision(opts?: {
+        decisionId?: string;
+        winningMemoryId?: number;
+        resolution?: string;
+        note?: string;
+    }): Promise<Record<string, unknown>>;
+    /**
+     * The intelligence report: themes, entities, patterns, dual-horizon view.
+     *
+     * `scope` is explicit by design server-side — nothing is inferred, so if you do
+     * not ask for a scope you do not get it.
+     */
+    intelligence(opts?: {
+        limit?: number;
+        scope?: string;
+        projectId?: string;
+    }): Promise<Record<string, unknown>>;
+    /** Counts and coverage for the knowledge base. */
+    knowledgeStats(): Promise<Record<string, unknown>>;
+    /** Add a conversation turn and extract memories from it. */
+    addTurn(req: {
+        tenantId: string;
+        userId: string;
+        messages: Array<Record<string, unknown>>;
+        sessionId?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<Record<string, unknown>>;
+    /**
+     * Build a prompt-ready context block for an LLM call.
+     *
+     * `types` narrows the result to those content types. Names outside the
+     * organization's vocabulary are dropped rather than rejected, so a stale client
+     * gets a narrower answer instead of an error.
+     */
+    recall(req: {
+        tenantId: string;
+        userId: string;
+        prompt: string;
+        k?: number;
+        types?: string[];
+    }): Promise<Record<string, unknown>>;
+    /** Async ingestion status for one memory. */
+    status(memoryId: number): Promise<Record<string, unknown>>;
+    /** Page through a specific end user's memories. */
+    listMemories(req: {
+        tenantId: string;
+        userId: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<Record<string, unknown>>;
 }
 
-export { type AddRequest, type AddResponse, type AddSkippedResponse, type ApiKeyTestResponse, type ApiKeyTestStatus, type AuditActor, type AuditEvent, type AuditEventListResponse, type AuditEventQuery, type AuditResource, type AuditSortDirection, AuthError, type BulkAddItem, type BulkAddItemResult, type BulkAddResponse, type BulkRevokeApiKeyResult, type BulkRevokeApiKeysRequest, type BulkRevokeApiKeysResponse, type ComposeRequest, type ComposeResponse, ControlPlaneClient, type ControlPlaneConfig, type ControlPlaneRequestOptions, type CreateOrganizationRequest, type CreateWebhookRequest, type CreatedWebhook, type CurrentPlanResponse, type ExportResponse, type Integration, type IntegrationQuery, type LoginRequest, type LoginResponse, type MemoryRecord, MemorySyncClient, type MemorySyncConfig, MemorySyncError, NotFoundError, type OrganizationMembership, type OrganizationSettings, type OrganizationSettingsQuery, type Plan, type PlanLimits, type Project, type QueryFilters, type QueryRequest, type QueryResponse, RateLimitError, type RelationCreateRequest, type RelationRecord, type RelationshipType, type ReplayWebhookDeliveriesRequest, type ReplayWebhookDeliveriesResponse, ServerError, type Session, type SessionListResponse, type SummarizeRequest, type TeamMember, type TestWebhookRequest, type TestWebhookResponse, type UpdateRequest, type UpdateWebhookRequest, ValidationError, type Webhook, type WebhookDelivery, type WebhookDeliveryListResponse, type WebhookDeliveryQuery, type WebhookListResponse, type WebhookRetryConfig, type WebhookSignatureConfig };
+export { type AddRequest, type AddResponse, type AddSkippedResponse, type ApiKeyTestResponse, type ApiKeyTestStatus, type AuditActor, type AuditEvent, type AuditEventListResponse, type AuditEventQuery, type AuditResource, type AuditSortDirection, AuthError, type BatchUpdateItem, type BatchUpdateItemResult, type BatchUpdateResponse, type BulkAddItem, type BulkAddItemResult, type BulkAddResponse, type BulkRevokeApiKeyResult, type BulkRevokeApiKeysRequest, type BulkRevokeApiKeysResponse, type ComposeRequest, type ComposeResponse, ControlPlaneClient, type ControlPlaneConfig, type ControlPlaneRequestOptions, type CreateOrganizationRequest, type CreateWebhookRequest, type CreatedWebhook, type CurrentPlanResponse, type ExportResponse, type FeedbackResponse, type FeedbackSignal, type FeedbackSummary, type FeedbackTrend, type ForgetFilters, type ForgetRequest, type HistoryResponse, type Integration, type IntegrationQuery, type LoginRequest, type LoginResponse, type MemoryRecord, MemorySyncClient, type MemorySyncConfig, MemorySyncError, NotFoundError, type Ontology, type OntologyUpdateRequest, type OrganizationMembership, type OrganizationSettings, type OrganizationSettingsQuery, type Plan, type PlanLimits, type Project, type QueryFilters, type QueryRequest, type QueryResponse, RateLimitError, type RelationCreateRequest, type RelationRecord, type RelationshipType, type ReplayWebhookDeliveriesRequest, type ReplayWebhookDeliveriesResponse, type RevisionEntry, type RevisionEvent, ServerError, type Session, type SessionListResponse, type SummarizeRequest, type TeamMember, type TestWebhookRequest, type TestWebhookResponse, type UpdateRequest, type UpdateWebhookRequest, type UploadRequest, ValidationError, type Webhook, type WebhookDelivery, type WebhookDeliveryListResponse, type WebhookDeliveryQuery, type WebhookListResponse, type WebhookRetryConfig, type WebhookSignatureConfig };