@ixo/topic-protocol 0.3.0 → 0.5.0

package/dist/src/contracts/schemas.js

@@ -3,8 +3,10 @@ import agentRun from "../../schemas/agent-run.schema.json" with { type: "json" }
 import externalSessionBinding from "../../schemas/external-session-binding.schema.json" with { type: "json" };
 import roomPolicy from "../../schemas/room-policy.schema.json" with { type: "json" };
 import topicCapsule from "../../schemas/topic-capsule.schema.json" with { type: "json" };
+import topicContractState from "../../schemas/topic-contract-state.schema.json" with { type: "json" };
 import topicFileAttachment from "../../schemas/topic-file-attachment.schema.json" with { type: "json" };
 import topicIndexEntry from "../../schemas/topic-index-entry.schema.json" with { type: "json" };
+import topicIndex from "../../schemas/topic-index.schema.json" with { type: "json" };
 import topicMessage from "../../schemas/topic-message.schema.json" with { type: "json" };
 import topicOperation from "../../schemas/topic-operation.schema.json" with { type: "json" };
 import topicPreferences from "../../schemas/topic-preferences.schema.json" with { type: "json" };
@@ -20,8 +22,10 @@ export const SCHEMA_REGISTRY = Object.freeze({
     "external-session-binding": externalSessionBinding,
     "room-policy": roomPolicy,
     "topic-capsule": topicCapsule,
+    "topic-contract-state": topicContractState,
     "topic-file-attachment": topicFileAttachment,
     "topic-index-entry": topicIndexEntry,
+    "topic-index": topicIndex,
     "topic-message": topicMessage,
     "topic-operation": topicOperation,
     "topic-preferences": topicPreferences,

package/dist/src/contracts/schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/contracts/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,0CAA0C,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC3F,OAAO,QAAQ,MAAM,qCAAqC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACjF,OAAO,sBAAsB,MAAM,oDAAoD,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC9G,OAAO,UAAU,MAAM,uCAAuC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACrF,OAAO,YAAY,MAAM,yCAAyC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACzF,OAAO,mBAAmB,MAAM,iDAAiD,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACxG,OAAO,eAAe,MAAM,6CAA6C,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAChG,OAAO,YAAY,MAAM,yCAAyC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACzF,OAAO,cAAc,MAAM,2CAA2C,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC7F,OAAO,gBAAgB,MAAM,6CAA6C,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACjG,OAAO,WAAW,MAAM,wCAAwC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACvF,OAAO,kBAAkB,MAAM,gDAAgD,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACtG,OAAO,aAAa,MAAM,0CAA0C,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC3F,OAAO,SAAS,MAAM,sCAAsC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACnF,OAAO,UAAU,MAAM,uCAAuC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACrF,OAAO,kBAAkB,MAAM,gDAAgD,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAEtG,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3C,gBAAgB,EAAE,aAAa;IAC/B,WAAW,EAAE,QAAQ;IACrB,0BAA0B,EAAE,sBAAsB;IAClD,aAAa,EAAE,UAAU;IACzB,eAAe,EAAE,YAAY;IAC7B,uBAAuB,EAAE,mBAAmB;IAC5C,mBAAmB,EAAE,eAAe;IACpC,eAAe,EAAE,YAAY;IAC7B,iBAAiB,EAAE,cAAc;IACjC,mBAAmB,EAAE,gBAAgB;IACrC,cAAc,EAAE,WAAW;IAC3B,sBAAsB,EAAE,kBAAkB;IAC1C,gBAAgB,EAAE,aAAa;IAC/B,YAAY,EAAE,SAAS;IACvB,aAAa,EAAE,UAAU;IACzB,sBAAsB,EAAE,kBAAkB;CAC3C,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CACzC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,IAAI,EAAoB,CACtD,CAAC"}
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/contracts/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,0CAA0C,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC3F,OAAO,QAAQ,MAAM,qCAAqC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACjF,OAAO,sBAAsB,MAAM,oDAAoD,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC9G,OAAO,UAAU,MAAM,uCAAuC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACrF,OAAO,YAAY,MAAM,yCAAyC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACzF,OAAO,kBAAkB,MAAM,gDAAgD,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACtG,OAAO,mBAAmB,MAAM,iDAAiD,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACxG,OAAO,eAAe,MAAM,6CAA6C,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAChG,OAAO,UAAU,MAAM,uCAAuC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACrF,OAAO,YAAY,MAAM,yCAAyC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACzF,OAAO,cAAc,MAAM,2CAA2C,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC7F,OAAO,gBAAgB,MAAM,6CAA6C,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACjG,OAAO,WAAW,MAAM,wCAAwC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACvF,OAAO,kBAAkB,MAAM,gDAAgD,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACtG,OAAO,aAAa,MAAM,0CAA0C,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC3F,OAAO,SAAS,MAAM,sCAAsC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACnF,OAAO,UAAU,MAAM,uCAAuC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACrF,OAAO,kBAAkB,MAAM,gDAAgD,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAEtG,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3C,gBAAgB,EAAE,aAAa;IAC/B,WAAW,EAAE,QAAQ;IACrB,0BAA0B,EAAE,sBAAsB;IAClD,aAAa,EAAE,UAAU;IACzB,eAAe,EAAE,YAAY;IAC7B,sBAAsB,EAAE,kBAAkB;IAC1C,uBAAuB,EAAE,mBAAmB;IAC5C,mBAAmB,EAAE,eAAe;IACpC,aAAa,EAAE,UAAU;IACzB,eAAe,EAAE,YAAY;IAC7B,iBAAiB,EAAE,cAAc;IACjC,mBAAmB,EAAE,gBAAgB;IACrC,cAAc,EAAE,WAAW;IAC3B,sBAAsB,EAAE,kBAAkB;IAC1C,gBAAgB,EAAE,aAAa;IAC/B,YAAY,EAAE,SAAS;IACvB,aAAa,EAAE,UAAU;IACzB,sBAAsB,EAAE,kBAAkB;CAC3C,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CACzC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,IAAI,EAAoB,CACtD,CAAC"}

package/dist/src/contracts/topic-contract.d.ts

@@ -0,0 +1,149 @@
+export declare const PERSISTED_TOPIC_KINDS: readonly ["task", "agent_task", "proposal", "evaluation", "claims", "question", "discussion", "incident"];
+export declare const TOPIC_CONTRACT_RECIPES: readonly ["project", "flow", "proposal", "evaluation", "claims", "research", "discussion", "incident"];
+export type PersistedTopicKind = (typeof PERSISTED_TOPIC_KINDS)[number];
+export type TopicContractRecipe = (typeof TOPIC_CONTRACT_RECIPES)[number];
+export type TopicKindRef = {
+    readonly source: "standard";
+    readonly kind: PersistedTopicKind;
+} | {
+    readonly source: "custom";
+    readonly customId: string;
+    readonly label: string;
+    readonly baseKind: PersistedTopicKind;
+};
+export type TopicIconName = "task" | "agent" | "proposal" | "evaluation" | "claims" | "question" | "discussion" | "incident";
+export type TopicAppearance = {
+    readonly glyph?: {
+        readonly type: "emoji";
+        readonly value: string;
+    } | {
+        readonly type: "icon";
+        readonly name: TopicIconName;
+    };
+};
+export interface TopicStatementV2 {
+    readonly id: string;
+    readonly text: string;
+    readonly provenance: {
+        readonly basis: "explicit" | "contextual" | "inferred" | "suggested" | "retrieved";
+        readonly acceptance: "proposed" | "accepted" | "rejected" | "superseded";
+        readonly sourceEventIds: readonly string[];
+        readonly createdBy?: string;
+        readonly createdAt?: string;
+    };
+}
+export type TemporalTarget = {
+    readonly precision: "date";
+    readonly value: string;
+    readonly timezone: string;
+} | {
+    readonly precision: "datetime";
+    readonly value: string;
+    readonly timezone: string;
+};
+export interface TopicRiskV2 {
+    readonly id: string;
+    readonly description: string;
+    readonly impact?: "low" | "medium" | "high" | "critical";
+    readonly status: "open" | "mitigated" | "accepted" | "closed";
+    readonly owner?: string;
+    readonly mitigation?: string;
+}
+export interface TopicOutcomeV2 {
+    readonly statement?: TopicStatementV2;
+    readonly status?: "proposed" | "accepted" | "achieved" | "abandoned";
+    readonly target?: TemporalTarget;
+    readonly successCriteria?: readonly {
+        readonly id: string;
+        readonly description: string;
+        readonly status: "pending" | "met" | "not_met" | "waived";
+        readonly verification?: {
+            readonly method: "human" | "agent" | "oracle" | "claim" | "artifact" | "custom";
+            readonly evaluator?: string;
+            readonly evidenceRequired?: readonly string[];
+        };
+    }[];
+    readonly outcomeRecordId?: string;
+    readonly abandonedReason?: string;
+}
+export interface TopicContractBodyV2 {
+    readonly version: 2;
+    readonly revision: string;
+    readonly status: "draft" | "accepted" | "superseded";
+    readonly kindRef: TopicKindRef;
+    readonly authoredBy: string;
+    readonly authoredAt: string;
+    readonly workingMode: "solo" | "team" | "client";
+    readonly recipe: TopicContractRecipe;
+    readonly locale?: string;
+    readonly timezone?: string;
+    readonly temporalMode?: "finite" | "ongoing";
+    readonly tags?: readonly string[];
+    readonly appearance?: TopicAppearance;
+    readonly intent?: TopicStatementV2;
+    readonly outcome?: TopicOutcomeV2;
+    readonly completion?: {
+        readonly definition?: string;
+        readonly acceptanceAuthorityIds?: readonly string[];
+        readonly requiresOutcomeRecord?: boolean;
+        readonly reviewAt?: string;
+    };
+    readonly ownerId?: string;
+    readonly scope?: {
+        readonly included?: readonly TopicStatementV2[];
+        readonly excluded?: readonly TopicStatementV2[];
+    };
+    readonly constraints?: readonly TopicStatementV2[];
+    readonly assumptions?: readonly Readonly<Record<string, unknown>>[];
+    readonly questions?: readonly Readonly<Record<string, unknown>>[];
+    readonly risks?: readonly TopicRiskV2[];
+    readonly participants?: readonly Readonly<Record<string, unknown>>[];
+    readonly roles?: readonly Readonly<Record<string, unknown>>[];
+    readonly agents?: readonly Readonly<Record<string, unknown>>[];
+    readonly decision?: Readonly<Record<string, unknown>>;
+    readonly plan?: Readonly<Record<string, unknown>>;
+    readonly attachments?: readonly Readonly<Record<string, unknown>>[];
+}
+export type TopicReminder = {
+    readonly mode: "at";
+    readonly at: string;
+    readonly timezone: string;
+} | {
+    readonly mode: "before_due";
+    readonly minutes: number;
+};
+export interface TopicUserSettings {
+    readonly companion?: {
+        readonly oracleDid: string;
+        readonly sessionId: string;
+        readonly lastContextRevision?: string;
+    };
+    readonly reminder?: TopicReminder;
+}
+export type Weekday = "monday" | "tuesday" | "wednesday" | "thursday" | "friday" | "saturday" | "sunday";
+export type TopicRecurrence = {
+    readonly frequency: "daily";
+    readonly time: string;
+    readonly timezone: string;
+} | {
+    readonly frequency: "weekly";
+    readonly days: readonly Weekday[];
+    readonly time: string;
+    readonly timezone: string;
+};
+export interface TopicAutomationBindingV2 {
+    readonly provider: "temporal";
+    readonly scheduleId: string;
+    readonly actionId: string;
+    readonly recurrence: TopicRecurrence;
+    readonly status: "pending" | "active" | "paused" | "failed";
+    readonly nextRunAt?: string;
+}
+export declare function baseTopicKind(kindRef: TopicKindRef): PersistedTopicKind;
+export declare function topicRecipeForKind(kindRef: TopicKindRef): TopicContractRecipe;
+export interface TopicContractCompletenessIssue {
+    readonly path: string;
+    readonly message: string;
+}
+export declare function contractCompleteness(body: TopicContractBodyV2): readonly TopicContractCompletenessIssue[];
+export declare function assertContractComplete(body: TopicContractBodyV2): void;

package/dist/src/contracts/topic-contract.js

@@ -0,0 +1,104 @@
+import { TopicProtocolError } from "../errors.js";
+export const PERSISTED_TOPIC_KINDS = [
+    "task",
+    "agent_task",
+    "proposal",
+    "evaluation",
+    "claims",
+    "question",
+    "discussion",
+    "incident",
+];
+export const TOPIC_CONTRACT_RECIPES = [
+    "project",
+    "flow",
+    "proposal",
+    "evaluation",
+    "claims",
+    "research",
+    "discussion",
+    "incident",
+];
+const RECIPE_BY_KIND = {
+    task: "project",
+    agent_task: "flow",
+    proposal: "proposal",
+    evaluation: "evaluation",
+    claims: "claims",
+    question: "research",
+    discussion: "discussion",
+    incident: "incident",
+};
+export function baseTopicKind(kindRef) {
+    return kindRef.source === "standard" ? kindRef.kind : kindRef.baseKind;
+}
+export function topicRecipeForKind(kindRef) {
+    return RECIPE_BY_KIND[baseTopicKind(kindRef)];
+}
+function requiredText(value, path, message) {
+    return value?.trim() ? [] : [{ path, message }];
+}
+function acceptedOutcome(body) {
+    const outcome = body.outcome;
+    if (outcome?.status === "achieved" && !outcome.outcomeRecordId) {
+        return [{ path: "/outcome/outcomeRecordId", message: "Achieved outcomes require an accepted outcome record" }];
+    }
+    return [];
+}
+function outcomeRequirements(body, kind) {
+    if (!["task", "agent_task", "proposal", "evaluation", "claims", "question"].includes(kind))
+        return [];
+    return requiredText(body.outcome?.statement?.text, "/outcome/statement/text", `Accepted ${kind} contracts require an outcome`);
+}
+function kindRequirements(body, kind) {
+    const issues = [];
+    if (kind === "task" && !body.ownerId) {
+        issues.push({ path: "/ownerId", message: "Accepted Tasks require an owner" });
+    }
+    if (kind === "agent_task" && (body.agents?.length ?? 0) === 0) {
+        issues.push({ path: "/agents", message: "Accepted Agent Tasks require an agent assignment" });
+    }
+    if (kind === "proposal" && body.decision === undefined) {
+        issues.push({ path: "/decision", message: "Accepted Proposals require an approval model" });
+    }
+    if (kind === "evaluation" && body.decision === undefined) {
+        issues.push({ path: "/decision", message: "Accepted Evaluations require criteria and authority" });
+    }
+    if (kind === "claims" && (body.attachments?.length ?? 0) === 0) {
+        issues.push({ path: "/attachments", message: "Accepted Claims Topics require a deed or claim-collection binding" });
+    }
+    return issues;
+}
+function lifecycleRequirements(body, kind) {
+    if (kind === "discussion" && body.temporalMode !== "ongoing") {
+        return requiredText(body.completion?.definition, "/completion/definition", "Finite Discussions require a closure rule");
+    }
+    if (kind !== "incident")
+        return [];
+    const issues = requiredText(body.completion?.definition, "/completion/definition", "Accepted Incidents require closure conditions");
+    if (!body.ownerId)
+        issues.push({ path: "/ownerId", message: "Accepted Incidents require a response owner" });
+    return issues;
+}
+export function contractCompleteness(body) {
+    if (body.status === "draft" || body.status === "superseded")
+        return acceptedOutcome(body);
+    const issues = [];
+    issues.push(...requiredText(body.intent?.text, "/intent/text", "Accepted contracts require an intent"));
+    issues.push(...acceptedOutcome(body));
+    const kind = baseTopicKind(body.kindRef);
+    if (body.recipe !== topicRecipeForKind(body.kindRef)) {
+        issues.push({ path: "/recipe", message: `Recipe must match the ${kind} kind` });
+    }
+    issues.push(...outcomeRequirements(body, kind));
+    issues.push(...kindRequirements(body, kind));
+    issues.push(...lifecycleRequirements(body, kind));
+    return issues;
+}
+export function assertContractComplete(body) {
+    const issues = contractCompleteness(body);
+    if (issues.length === 0)
+        return;
+    throw new TopicProtocolError("CONTRACT_VALIDATION_FAILED", "Topic contract is incomplete for acceptance", { contract: "topic-contract-state", errors: issues });
+}
+//# sourceMappingURL=topic-contract.js.map

package/dist/src/contracts/topic-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"topic-contract.js","sourceRoot":"","sources":["../../../src/contracts/topic-contract.ts"],"names":[],"mappings":"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"}

package/dist/src/index.d.ts

@@ -1,13 +1,18 @@
 export { CONTRACT_NAMES, type ContractName, } from "./contracts/schemas.js";
 export { assertContract, validateContract, type ContractValidationError, type ContractValidationResult, } from "./contracts/validator.js";
+export { PERSISTED_TOPIC_KINDS, TOPIC_CONTRACT_RECIPES, assertContractComplete, baseTopicKind, contractCompleteness, topicRecipeForKind, type PersistedTopicKind, type TemporalTarget, type TopicAppearance, type TopicAutomationBindingV2, type TopicContractBodyV2, type TopicContractCompletenessIssue, type TopicContractRecipe, type TopicIconName, type TopicKindRef, type TopicRecurrence, type TopicReminder, type TopicRiskV2, type TopicStatementV2, type TopicUserSettings, type Weekday, } from "./contracts/topic-contract.js";
 export { TopicProtocolError, type TopicProtocolErrorCode, } from "./errors.js";
 export { projectTopic } from "./projector/project.js";
-export { selectCanonicalTopicAnchor } from "./matrix/anchors.js";
+export { adoptedTopicAnchor, nativeTopicAnchor, selectCanonicalTopicAnchor } from "./matrix/anchors.js";
 export { assertMatrixAnchor, assertMatrixRoomId, assertServerEventId, assertTopicMessageContent, buildTopicMessageContent, buildTopicOperationContent, buildTopicRootContent, createTopicId, createTopicOperationId, } from "./matrix/content.js";
 export { TOPIC_RECORD_KEY, TOPIC_RECORD_MSGTYPE, TOPIC_SOURCE_KEY, TOPIC_SOURCE_KINDS, TOPIC_SOURCE_MSGTYPE, createTopicRecordMessageContent, createTopicSourceMessageContent, parseTopicRecordMessageContent, parseTopicSourceMessageContent, type CreateTopicRecordMessageInput, type CreateTopicSourceMessageInput, type TopicCardContext, type TopicRecordMessageContent, type TopicSourceDisclosure, type TopicSourceKind, type TopicSourceMessageContent, type TopicSourceReference, } from "./matrix/cards.js";
 export { isTopicInfrastructureEvent, parseTopicRootEvent, projectMatrixTopic, } from "./matrix/events.js";
 export { JsonPendingTopicStore, MemoryPendingTopicStore, type TopicKeyValueStore, } from "./matrix/pending.js";
 export { TopicRuntime, type TopicRuntimeOptions } from "./matrix/runtime.js";
 export { MATRIX_ROOM_MESSAGE, TOPIC_ANCHOR_KEY, TOPIC_METADATA_KEY, TOPIC_OPERATION_EVENT_TYPE, type CanonicalTopicAnchor, type MatrixEventContent, type MatrixSendRequest, type MatrixTopicProjection, type MatrixTopicProjectionInput, type ParsedTopicRoot, type PendingTopicCreation, type PendingTopicStore, type RejectedTopicEvent, type RejectedTopicEventReason, type TopicAnchorConflict, type TopicCreationInput, type TopicCreationResult, type TopicFirstMessageFactory, type TopicMatrixEvent, type TopicMatrixTransport, type TopicRootContentOptions, } from "./matrix/types.js";
-export { TOPIC_KINDS, TOPIC_CONTEXT_TYPES, TOPIC_STATUSES, TOPIC_VFS_FILE_PROVIDER, type IgnoredOperation, type IgnoredOperationReason, type MatrixAnchor, type ProjectedTopicRelation, type ProjectionInput, type TopicContext, type TopicContextType, type TopicFileAttachmentIdentity, type TopicDecision, type TopicKind, type TopicNextStep, type TopicOperation, type TopicOperationType, type TopicProjection, type ProjectedTopicAttachment, type ProjectedTopicOverview, type TopicOverview, type TopicProjectionConflict, type TopicRelationType, type TopicRoot, type TopicStatus, type TopicVfsFileReference, isCanonicalTopicContextType, } from "./projector/types.js";
+export { TOPIC_KINDS, TOPIC_CONTEXT_TYPES, TOPIC_STATUSES, TOPIC_VFS_FILE_PROVIDER, type IgnoredOperation, type IgnoredOperationReason, type MatrixAnchor, type TopicAnchor, type ProjectedTopicRelation, type ProjectionInput, type TopicContext, type TopicContextType, type TopicFileAttachmentIdentity, type TopicDecision, type EffectiveTopicContractReference, type TopicAutomationBinding, type TopicAutomationStatus, type TopicContractHeads, type TopicContractReference, type TopicKind, type TopicNextStep, type TopicOperation, type TopicOperationType, type TopicProjection, type ProjectedTopicAttachment, type ProjectedTopicOverview, type TopicOverview, type TopicProjectionConflict, type TopicRelationType, type TopicRoot, type TopicRootV2, type LegacyTopicRoot, type TopicStatus, type TopicVfsFileReference, isCanonicalTopicContextType, } from "./projector/types.js";
 export { TOPIC_RECORD_KINDS, type TopicRecord, type TopicRecordKind, } from "./records/types.js";
+export { emptyTopicIndexSnapshot, reconcileTopicIndex } from "./indexing/reconcile.js";
+export { searchTopicIndex } from "./indexing/search.js";
+export { rankTopicIndex } from "./indexing/rank.js";
+export { TOPIC_INDEX_COMPLETENESS, TOPIC_INDEX_RANK_REASONS, TOPIC_INDEX_STORAGE_STATES, TOPIC_INDEX_UNREAD_STATES, TOPIC_NOTIFICATION_MODES, type RankedTopicIndexEntry, type TopicAttentionSignalMap, type TopicAttentionSignals, type TopicIndexCompleteness, type TopicIndexDomain, type TopicIndexEntry, type TopicIndexObservation, type TopicIndexRankReason, type TopicIndexReconciliation, type TopicIndexSearchFilters, type TopicIndexSnapshot, type TopicIndexStorageState, type TopicIndexTombstone, type TopicIndexUnreadState, type TopicNotificationMode, type TopicPreference, type TopicPreferenceMap, } from "./indexing/types.js";

package/dist/src/index.js

@@ -1,8 +1,9 @@
 export { CONTRACT_NAMES, } from "./contracts/schemas.js";
 export { assertContract, validateContract, } from "./contracts/validator.js";
+export { PERSISTED_TOPIC_KINDS, TOPIC_CONTRACT_RECIPES, assertContractComplete, baseTopicKind, contractCompleteness, topicRecipeForKind, } from "./contracts/topic-contract.js";
 export { TopicProtocolError, } from "./errors.js";
 export { projectTopic } from "./projector/project.js";
-export { selectCanonicalTopicAnchor } from "./matrix/anchors.js";
+export { adoptedTopicAnchor, nativeTopicAnchor, selectCanonicalTopicAnchor } from "./matrix/anchors.js";
 export { assertMatrixAnchor, assertMatrixRoomId, assertServerEventId, assertTopicMessageContent, buildTopicMessageContent, buildTopicOperationContent, buildTopicRootContent, createTopicId, createTopicOperationId, } from "./matrix/content.js";
 export { TOPIC_RECORD_KEY, TOPIC_RECORD_MSGTYPE, TOPIC_SOURCE_KEY, TOPIC_SOURCE_KINDS, TOPIC_SOURCE_MSGTYPE, createTopicRecordMessageContent, createTopicSourceMessageContent, parseTopicRecordMessageContent, parseTopicSourceMessageContent, } from "./matrix/cards.js";
 export { isTopicInfrastructureEvent, parseTopicRootEvent, projectMatrixTopic, } from "./matrix/events.js";
@@ -11,4 +12,8 @@ export { TopicRuntime } from "./matrix/runtime.js";
 export { MATRIX_ROOM_MESSAGE, TOPIC_ANCHOR_KEY, TOPIC_METADATA_KEY, TOPIC_OPERATION_EVENT_TYPE, } from "./matrix/types.js";
 export { TOPIC_KINDS, TOPIC_CONTEXT_TYPES, TOPIC_STATUSES, TOPIC_VFS_FILE_PROVIDER, isCanonicalTopicContextType, } from "./projector/types.js";
 export { TOPIC_RECORD_KINDS, } from "./records/types.js";
+export { emptyTopicIndexSnapshot, reconcileTopicIndex } from "./indexing/reconcile.js";
+export { searchTopicIndex } from "./indexing/search.js";
+export { rankTopicIndex } from "./indexing/rank.js";
+export { TOPIC_INDEX_COMPLETENESS, TOPIC_INDEX_RANK_REASONS, TOPIC_INDEX_STORAGE_STATES, TOPIC_INDEX_UNREAD_STATES, TOPIC_NOTIFICATION_MODES, } from "./indexing/types.js";
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,GAEf,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,cAAc,EACd,gBAAgB,GAGjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,kBAAkB,GAEnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,0BAA0B,EAC1B,qBAAqB,EACrB,aAAa,EACb,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,+BAA+B,EAC/B,+BAA+B,EAC/B,8BAA8B,EAC9B,8BAA8B,GAS/B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,0BAA0B,EAC1B,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,qBAAqB,EACrB,uBAAuB,GAExB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAA4B,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,0BAA0B,GAkB3B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,uBAAuB,EAuBvB,2BAA2B,GAC5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,kBAAkB,GAGnB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,GAEf,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,cAAc,EACd,gBAAgB,GAGjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,aAAa,EACb,oBAAoB,EACpB,kBAAkB,GAgBnB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,kBAAkB,GAEnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACxG,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,0BAA0B,EAC1B,qBAAqB,EACrB,aAAa,EACb,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,+BAA+B,EAC/B,+BAA+B,EAC/B,8BAA8B,EAC9B,8BAA8B,GAS/B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,0BAA0B,EAC1B,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,qBAAqB,EACrB,uBAAuB,GAExB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAA4B,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,0BAA0B,GAkB3B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,uBAAuB,EA+BvB,2BAA2B,GAC5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,kBAAkB,GAGnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,0BAA0B,EAC1B,yBAAyB,EACzB,wBAAwB,GAkBzB,MAAM,qBAAqB,CAAC"}

package/dist/src/indexing/rank.d.ts

@@ -0,0 +1,2 @@
+import type { RankedTopicIndexEntry, TopicAttentionSignalMap, TopicIndexEntry, TopicPreferenceMap } from "./types.js";
+export declare function rankTopicIndex(entries: readonly TopicIndexEntry[], preferences?: TopicPreferenceMap, signals?: TopicAttentionSignalMap): RankedTopicIndexEntry[];

package/dist/src/indexing/rank.js

@@ -0,0 +1,31 @@
+import { compareText } from "../shared/compare.js";
+const REASON_RANK = {
+    pinned: 0,
+    "direct-attention": 1,
+    "followed-unread": 2,
+    participated: 3,
+    recent: 4,
+};
+function reasonFor(entry, preferences, signals) {
+    const preference = preferences[entry.topicId];
+    if (preference?.pinned)
+        return "pinned";
+    if (signals[entry.topicId]?.directAttention)
+        return "direct-attention";
+    if (preference?.notificationMode === "follow" && entry.unread === "unread")
+        return "followed-unread";
+    if (entry.participated)
+        return "participated";
+    return "recent";
+}
+function compareRanked(left, right) {
+    return REASON_RANK[left.reason] - REASON_RANK[right.reason]
+        || compareText(right.entry.latestActivityAt, left.entry.latestActivityAt)
+        || compareText(left.entry.topicId, right.entry.topicId);
+}
+export function rankTopicIndex(entries, preferences = {}, signals = {}) {
+    return entries
+        .map((entry) => ({ entry, reason: reasonFor(entry, preferences, signals) }))
+        .sort(compareRanked);
+}
+//# sourceMappingURL=rank.js.map

package/dist/src/indexing/rank.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rank.js","sourceRoot":"","sources":["../../../src/indexing/rank.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AASnD,MAAM,WAAW,GAAyC;IACxD,MAAM,EAAE,CAAC;IACT,kBAAkB,EAAE,CAAC;IACrB,iBAAiB,EAAE,CAAC;IACpB,YAAY,EAAE,CAAC;IACf,MAAM,EAAE,CAAC;CACV,CAAC;AAEF,SAAS,SAAS,CAAC,KAAsB,EAAE,WAA+B,EAAE,OAAgC;IAC1G,MAAM,UAAU,GAAG,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,UAAU,EAAE,MAAM;QAAE,OAAO,QAAQ,CAAC;IACxC,IAAI,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,eAAe;QAAE,OAAO,kBAAkB,CAAC;IACvE,IAAI,UAAU,EAAE,gBAAgB,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,iBAAiB,CAAC;IACrG,IAAI,KAAK,CAAC,YAAY;QAAE,OAAO,cAAc,CAAC;IAC9C,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,aAAa,CAAC,IAA2B,EAAE,KAA4B;IAC9E,OAAO,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC;WACtD,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,gBAAgB,EAAE,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC;WACtE,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,OAAmC,EACnC,cAAkC,EAAE,EACpC,UAAmC,EAAE;IAErC,OAAO,OAAO;SACX,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;SAC3E,IAAI,CAAC,aAAa,CAAC,CAAC;AACzB,CAAC"}

package/dist/src/indexing/reconcile.d.ts

@@ -0,0 +1,3 @@
+import type { TopicIndexReconciliation, TopicIndexSnapshot } from "./types.js";
+export declare function emptyTopicIndexSnapshot(updatedAt: string): TopicIndexSnapshot;
+export declare function reconcileTopicIndex(snapshot: TopicIndexSnapshot, input: TopicIndexReconciliation): TopicIndexSnapshot;

package/dist/src/indexing/reconcile.js

@@ -0,0 +1,58 @@
+import { compareText } from "../shared/compare.js";
+const COMPLETENESS_RANK = {
+    complete: 4,
+    "partial-history": 3,
+    "metadata-pending": 2,
+    "decryption-pending": 1,
+};
+function compareEntries(left, right) {
+    return compareText(left.indexedAt, right.indexedAt)
+        || COMPLETENESS_RANK[left.completeness] - COMPLETENESS_RANK[right.completeness]
+        || compareText(right.roomId, left.roomId)
+        || compareText(right.rootEventId, left.rootEventId);
+}
+function latestEntries(entries) {
+    const byTopic = new Map();
+    entries.forEach((entry) => {
+        const current = byTopic.get(entry.topicId);
+        if (current === undefined || compareEntries(current, entry) < 0)
+            byTopic.set(entry.topicId, entry);
+    });
+    return byTopic;
+}
+function latestTombstones(tombstones) {
+    const byRoom = new Map();
+    tombstones.forEach((tombstone) => {
+        const current = byRoom.get(tombstone.roomId);
+        if (current === undefined || compareText(current.removedAt, tombstone.removedAt) < 0)
+            byRoom.set(tombstone.roomId, tombstone);
+    });
+    return byRoom;
+}
+function isAfterTombstone(entry, tombstones) {
+    const tombstone = tombstones.get(entry.roomId);
+    return tombstone === undefined || compareText(tombstone.removedAt, entry.indexedAt) < 0;
+}
+export function emptyTopicIndexSnapshot(updatedAt) {
+    return { version: 1, updatedAt, entries: [], tombstones: [] };
+}
+export function reconcileTopicIndex(snapshot, input) {
+    const removed = new Set(input.leftRoomIds ?? []);
+    const tombstones = latestTombstones([
+        ...snapshot.tombstones,
+        ...[...removed].map((roomId) => ({ roomId, removedAt: input.reconciledAt })),
+    ]);
+    const observed = input.observations
+        .filter(({ canonicalAnchor }) => canonicalAnchor)
+        .map(({ entry }) => entry);
+    const entries = [...latestEntries([...snapshot.entries, ...observed]).values()]
+        .filter((entry) => !removed.has(entry.roomId) && isAfterTombstone(entry, tombstones))
+        .sort((left, right) => compareText(left.topicId, right.topicId));
+    return {
+        version: 1,
+        updatedAt: input.reconciledAt,
+        entries,
+        tombstones: [...tombstones.values()].sort((left, right) => compareText(left.roomId, right.roomId)),
+    };
+}
+//# sourceMappingURL=reconcile.js.map

package/dist/src/indexing/reconcile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile.js","sourceRoot":"","sources":["../../../src/indexing/reconcile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAQnD,MAAM,iBAAiB,GAAG;IACxB,QAAQ,EAAE,CAAC;IACX,iBAAiB,EAAE,CAAC;IACpB,kBAAkB,EAAE,CAAC;IACrB,oBAAoB,EAAE,CAAC;CACf,CAAC;AAEX,SAAS,cAAc,CAAC,IAAqB,EAAE,KAAsB;IACnE,OAAO,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC;WAC9C,iBAAiB,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,iBAAiB,CAAC,KAAK,CAAC,YAAY,CAAC;WAC5E,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;WACtC,WAAW,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,aAAa,CAAC,OAAmC;IACxD,MAAM,OAAO,GAAG,IAAI,GAAG,EAA2B,CAAC;IACnD,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACxB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC3C,IAAI,OAAO,KAAK,SAAS,IAAI,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACrG,CAAC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,gBAAgB,CAAC,UAA0C;IAClE,MAAM,MAAM,GAAG,IAAI,GAAG,EAA+B,CAAC;IACtD,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE;QAC/B,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC7C,IAAI,OAAO,KAAK,SAAS,IAAI,WAAW,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAChI,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAsB,EAAE,UAAoD;IACpG,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC/C,OAAO,SAAS,KAAK,SAAS,IAAI,WAAW,CAAC,SAAS,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;AAC1F,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,SAAiB;IACvD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,QAA4B,EAC5B,KAA+B;IAE/B,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,gBAAgB,CAAC;QAClC,GAAG,QAAQ,CAAC,UAAU;QACtB,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC;KAC7E,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,KAAK,CAAC,YAAY;SAChC,MAAM,CAAC,CAAC,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC;SAChD,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;IAC7B,MAAM,OAAO,GAAG,CAAC,GAAG,aAAa,CAAC,CAAC,GAAG,QAAQ,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SAC5E,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,gBAAgB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;SACpF,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IACnE,OAAO;QACL,OAAO,EAAE,CAAC;QACV,SAAS,EAAE,KAAK,CAAC,YAAY;QAC7B,OAAO;QACP,UAAU,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;KACnG,CAAC;AACJ,CAAC"}

package/dist/src/indexing/search.d.ts

@@ -0,0 +1,2 @@
+import type { TopicIndexEntry, TopicIndexSearchFilters, TopicPreferenceMap } from "./types.js";
+export declare function searchTopicIndex(entries: readonly TopicIndexEntry[], filters?: TopicIndexSearchFilters, preferences?: TopicPreferenceMap): TopicIndexEntry[];

package/dist/src/indexing/search.js

@@ -0,0 +1,37 @@
+import { compareText } from "../shared/compare.js";
+function includesAny(value, accepted) {
+    return accepted === undefined || accepted.length === 0 || (value !== undefined && accepted.includes(value));
+}
+function includesSource(entry, accepted) {
+    return accepted === undefined || accepted.length === 0 || accepted.some((kind) => entry.sourceKinds?.includes(kind));
+}
+function searchText(entry) {
+    return [
+        entry.title,
+        entry.currentState,
+        entry.domain?.name,
+        entry.domain?.id,
+        ...(entry.context?.flatMap(({ type, id }) => [type, id]) ?? []),
+    ].filter((value) => value !== undefined).join(" ").toLowerCase();
+}
+function matchesQuery(entry, query) {
+    const tokens = query?.trim().toLowerCase().split(/\s+/).filter(Boolean) ?? [];
+    if (tokens.length === 0)
+        return true;
+    const haystack = searchText(entry);
+    return tokens.every((token) => haystack.includes(token));
+}
+function matchesFollowing(entry, following, preferences) {
+    if (following === undefined)
+        return true;
+    return (preferences[entry.topicId]?.notificationMode === "follow") === following;
+}
+export function searchTopicIndex(entries, filters = {}, preferences = {}) {
+    return entries.filter((entry) => matchesQuery(entry, filters.query)
+        && includesAny(entry.status, filters.statuses)
+        && includesAny(entry.domain?.id, filters.domainIds)
+        && includesAny(entry.kind, filters.kinds)
+        && includesSource(entry, filters.sourceKinds)
+        && matchesFollowing(entry, filters.following, preferences)).sort((left, right) => compareText(left.title ?? "", right.title ?? "") || compareText(left.topicId, right.topicId));
+}
+//# sourceMappingURL=search.js.map

package/dist/src/indexing/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../src/indexing/search.ts"],"names":[],"mappings":"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"}

package/dist/src/indexing/types.d.ts

@@ -0,0 +1,76 @@
+import type { TopicSourceKind } from "../matrix/cards.js";
+import type { TopicContext, TopicKind, TopicStatus } from "../projector/types.js";
+import type { TopicUserSettings } from "../contracts/topic-contract.js";
+export declare const TOPIC_INDEX_COMPLETENESS: readonly ["complete", "partial-history", "metadata-pending", "decryption-pending"];
+export declare const TOPIC_INDEX_UNREAD_STATES: readonly ["unread", "read", "unknown"];
+export declare const TOPIC_INDEX_STORAGE_STATES: readonly ["encrypted", "memory-only", "locked", "unavailable"];
+export declare const TOPIC_NOTIFICATION_MODES: readonly ["follow", "default", "mute"];
+export declare const TOPIC_INDEX_RANK_REASONS: readonly ["pinned", "direct-attention", "followed-unread", "participated", "recent"];
+export type TopicIndexCompleteness = (typeof TOPIC_INDEX_COMPLETENESS)[number];
+export type TopicIndexUnreadState = (typeof TOPIC_INDEX_UNREAD_STATES)[number];
+export type TopicIndexStorageState = (typeof TOPIC_INDEX_STORAGE_STATES)[number];
+export type TopicNotificationMode = (typeof TOPIC_NOTIFICATION_MODES)[number];
+export type TopicIndexRankReason = (typeof TOPIC_INDEX_RANK_REASONS)[number];
+export interface TopicIndexDomain {
+    readonly id: string;
+    readonly name?: string;
+}
+export interface TopicIndexEntry {
+    readonly topicId: string;
+    readonly roomId: string;
+    readonly rootEventId: string;
+    readonly title?: string;
+    readonly currentState?: string;
+    readonly status: TopicStatus;
+    readonly kind?: TopicKind;
+    readonly domain?: TopicIndexDomain;
+    readonly context?: readonly TopicContext[];
+    readonly sourceKinds?: readonly TopicSourceKind[];
+    readonly latestActivityAt: string;
+    readonly latestEventId?: string;
+    readonly participated: boolean;
+    readonly unread: TopicIndexUnreadState;
+    readonly completeness: TopicIndexCompleteness;
+    readonly indexedAt: string;
+}
+export interface TopicIndexTombstone {
+    readonly roomId: string;
+    readonly removedAt: string;
+}
+export interface TopicIndexSnapshot {
+    readonly version: 1;
+    readonly updatedAt: string;
+    readonly entries: readonly TopicIndexEntry[];
+    readonly tombstones: readonly TopicIndexTombstone[];
+}
+export interface TopicPreference extends TopicUserSettings {
+    readonly notificationMode: TopicNotificationMode;
+    readonly pinned: boolean;
+    readonly markedUnreadFrom?: string | null;
+}
+export type TopicPreferenceMap = Readonly<Record<string, TopicPreference>>;
+export interface TopicIndexObservation {
+    readonly entry: TopicIndexEntry;
+    readonly canonicalAnchor: boolean;
+}
+export interface TopicIndexReconciliation {
+    readonly observations: readonly TopicIndexObservation[];
+    readonly leftRoomIds?: readonly string[];
+    readonly reconciledAt: string;
+}
+export interface TopicIndexSearchFilters {
+    readonly query?: string;
+    readonly statuses?: readonly TopicStatus[];
+    readonly domainIds?: readonly string[];
+    readonly following?: boolean;
+    readonly kinds?: readonly TopicKind[];
+    readonly sourceKinds?: readonly TopicSourceKind[];
+}
+export interface TopicAttentionSignals {
+    readonly directAttention?: boolean;
+}
+export type TopicAttentionSignalMap = Readonly<Record<string, TopicAttentionSignals>>;
+export interface RankedTopicIndexEntry {
+    readonly entry: TopicIndexEntry;
+    readonly reason: TopicIndexRankReason;
+}

package/dist/src/indexing/types.js

@@ -0,0 +1,22 @@
+export const TOPIC_INDEX_COMPLETENESS = [
+    "complete",
+    "partial-history",
+    "metadata-pending",
+    "decryption-pending",
+];
+export const TOPIC_INDEX_UNREAD_STATES = ["unread", "read", "unknown"];
+export const TOPIC_INDEX_STORAGE_STATES = [
+    "encrypted",
+    "memory-only",
+    "locked",
+    "unavailable",
+];
+export const TOPIC_NOTIFICATION_MODES = ["follow", "default", "mute"];
+export const TOPIC_INDEX_RANK_REASONS = [
+    "pinned",
+    "direct-attention",
+    "followed-unread",
+    "participated",
+    "recent",
+];
+//# sourceMappingURL=types.js.map

package/dist/src/indexing/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/indexing/types.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,UAAU;IACV,iBAAiB;IACjB,kBAAkB;IAClB,oBAAoB;CACZ,CAAC;AACX,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAU,CAAC;AAChF,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,WAAW;IACX,aAAa;IACb,QAAQ;IACR,aAAa;CACL,CAAC;AACX,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAU,CAAC;AAC/E,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,QAAQ;IACR,kBAAkB;IAClB,iBAAiB;IACjB,cAAc;IACd,QAAQ;CACA,CAAC"}

package/dist/src/matrix/anchors.d.ts

@@ -1,2 +1,5 @@
+import type { MatrixAnchor, TopicAnchor } from "../projector/types.js";
 import type { CanonicalTopicAnchor, TopicMatrixEvent } from "./types.js";
+export declare function nativeTopicAnchor(anchor: MatrixAnchor): TopicAnchor;
+export declare function adoptedTopicAnchor(anchor: MatrixAnchor): TopicAnchor;
 export declare function selectCanonicalTopicAnchor(events: readonly TopicMatrixEvent[], topicId: string): CanonicalTopicAnchor;