@semiont/core 0.5.11 → 0.5.12

package/dist/index.d.ts

@@ -3343,6 +3343,15 @@ interface components {
             domain: string;
             tags: components["schemas"]["TagCategory"][];
         };
+        /** @description Bus command to rebuild the graph projection from the event log — the whole graph when resourceId is absent, one resource when present. Served by the Weaver; replaces direct rebuild access, which does not survive the Weaver's container split. */
+        WeaveRebuildCommand: {
+            /** @description Correlation id for request/reply matching, set by busRequest so the ok/failed reply routes back. */
+            correlationId?: string;
+            /** @description When present, rebuild only this resource; otherwise clear and rebuild the entire graph. */
+            resourceId?: string;
+            /** @description Authenticated user's DID, injected by the /bus/emit gateway. Clients do not set this. */
+            _userId?: string;
+        };
         /** @description Bus command to create a cloned resource from a clone token. */
         YieldCloneCreateCommand: {
             correlationId: string;
@@ -3785,6 +3794,22 @@ type BindUpdateBodyCommand = components['schemas']['BindUpdateBodyCommand'] & {
  * - Commands/reads/results/UI: OpenAPI schema refs — plain strings
  * - void: UI-only signals with no payload
  */
+/**
+ * Viewport-space rectangle of a clicked annotation element — runtime-only
+ * view geometry riding UI events (never wire vocabulary; deliberately not in
+ * the OpenAPI schemas). Structurally satisfied by a DOM `DOMRect`, spelled
+ * out here because this package compiles without the DOM lib.
+ */
+interface AnchorRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
 type EventMap = {
     'yield:created': StoredEvent<EventOfType<'yield:created'>>;
     'yield:cloned': StoredEvent<EventOfType<'yield:cloned'>>;
@@ -3906,22 +3931,46 @@ type EventMap = {
     } & components['schemas']['CommandError'];
     'gather:annotation-progress': components['schemas']['GatherProgress'];
     'browse:resource-requested': components['schemas']['BrowseResourceRequest'];
-    'browse:resource-result': components['schemas']['BrowseResourceResult'];
+    'browse:resource-result': {
+        correlationId: string;
+        response: Omit<components['schemas']['GetResourceResponse'], 'resource' | 'annotations' | 'entityReferences'> & {
+            resource: ResourceDescriptor;
+            annotations: Annotation[];
+            entityReferences: Annotation[];
+        };
+    };
     'browse:resource-failed': {
         correlationId: string;
     } & components['schemas']['CommandError'];
     'browse:resources-requested': components['schemas']['BrowseResourcesRequest'];
-    'browse:resources-result': components['schemas']['BrowseResourcesResult'];
+    'browse:resources-result': {
+        correlationId: string;
+        response: Omit<components['schemas']['ListResourcesResponse'], 'resources'> & {
+            resources: ResourceDescriptor[];
+        };
+    };
     'browse:resources-failed': {
         correlationId: string;
     } & components['schemas']['CommandError'];
     'browse:annotations-requested': components['schemas']['BrowseAnnotationsRequest'];
-    'browse:annotations-result': components['schemas']['BrowseAnnotationsResult'];
+    'browse:annotations-result': {
+        correlationId: string;
+        response: Omit<components['schemas']['GetAnnotationsResponse'], 'annotations'> & {
+            annotations: Annotation[];
+        };
+    };
     'browse:annotations-failed': {
         correlationId: string;
     } & components['schemas']['CommandError'];
     'browse:annotation-requested': components['schemas']['BrowseAnnotationRequest'];
-    'browse:annotation-result': components['schemas']['BrowseAnnotationResult'];
+    'browse:annotation-result': {
+        correlationId: string;
+        response: Omit<components['schemas']['GetAnnotationResponse'], 'annotation' | 'resource' | 'resolvedResource'> & {
+            annotation: Annotation;
+            resource: ResourceDescriptor | null;
+            resolvedResource: ResourceDescriptor | null;
+        };
+    };
     'browse:annotation-failed': {
         correlationId: string;
     } & components['schemas']['CommandError'];
@@ -3969,11 +4018,15 @@ type EventMap = {
         correlationId: string;
         path: string;
     } & components['schemas']['CommandError'];
-    'browse:click': components['schemas']['BrowseClickEvent'];
+    'browse:click': components['schemas']['BrowseClickEvent'] & {
+        anchorRect?: AnchorRect;
+    };
     'browse:reference-navigate': components['schemas']['BrowseReferenceNavigateEvent'];
     'browse:entity-type-clicked': components['schemas']['BrowseEntityTypeClickedEvent'];
     'panel:toggle': components['schemas']['BrowsePanelToggleEvent'];
-    'panel:open': components['schemas']['BrowsePanelOpenEvent'];
+    'panel:open': components['schemas']['BrowsePanelOpenEvent'] & {
+        anchorRect?: AnchorRect;
+    };
     'panel:close': void;
     'shell:sidebar-toggle': void;
     'tabs:close': components['schemas']['BrowseResourceCloseEvent'];
@@ -4021,6 +4074,31 @@ type EventMap = {
         };
     };
     'job:cancel-failed': components['schemas']['CommandError'];
+    /**
+     * Emitted by the Weaver after applying an event (or a batch's last event)
+     * for a resource to the graph. `sequenceNumber` is the resource-stream
+     * sequence of the last applied event. Folded by `WeaveProgress`
+     * (make-meaning) into the backend-local applied map that the
+     * `whenApplied` barrier awaits. In-process signal today; crosses the
+     * bus gateway after WEAVER-ISOLATION.
+     */
+    'weave:applied': {
+        resourceId: string;
+        sequenceNumber: number;
+    };
+    'smelt:settled': {
+        resourceId: string;
+        contentChecksum: string;
+        outcome: 'indexed' | 'skipped';
+    };
+    'weave:rebuild': components['schemas']['WeaveRebuildCommand'];
+    'weave:rebuild-ok': {
+        correlationId?: string;
+    };
+    'weave:rebuild-failed': {
+        correlationId?: string;
+        message: string;
+    };
     'settings:theme-changed': components['schemas']['SettingsThemeChangedEvent'];
     'settings:line-numbers-toggled': void;
     'settings:locale-changed': components['schemas']['SettingsLocaleChangedEvent'];
@@ -4231,11 +4309,11 @@ declare const CHANNEL_SCHEMAS: {
     readonly 'browse:directory-requested': "BrowseDirectoryRequest";
     readonly 'browse:directory-result': "BrowseDirectoryResult";
     readonly 'browse:directory-failed': null;
-    readonly 'browse:click': "BrowseClickEvent";
+    readonly 'browse:click': null;
     readonly 'browse:reference-navigate': "BrowseReferenceNavigateEvent";
     readonly 'browse:entity-type-clicked': "BrowseEntityTypeClickedEvent";
     readonly 'panel:toggle': "BrowsePanelToggleEvent";
-    readonly 'panel:open': "BrowsePanelOpenEvent";
+    readonly 'panel:open': null;
     readonly 'panel:close': null;
     readonly 'shell:sidebar-toggle': null;
     readonly 'tabs:close': "BrowseResourceCloseEvent";
@@ -4271,6 +4349,11 @@ declare const CHANNEL_SCHEMAS: {
     readonly 'settings:line-numbers-toggled': null;
     readonly 'settings:locale-changed': "SettingsLocaleChangedEvent";
     readonly 'settings:hover-delay-changed': "SettingsHoverDelayChangedEvent";
+    readonly 'weave:applied': null;
+    readonly 'smelt:settled': null;
+    readonly 'weave:rebuild': "WeaveRebuildCommand";
+    readonly 'weave:rebuild-ok': null;
+    readonly 'weave:rebuild-failed': null;
     readonly 'stream-connected': null;
     readonly 'replay-window-exceeded': null;
     readonly 'bus:resume-gap': null;
@@ -4503,8 +4586,7 @@ declare class ScopedEventBus {
  *   idleTimeoutMs  — How long after the last flush before returning to passthrough.
  *                    200ms is a good default. Must be >= burstWindowMs.
  *
- * See: BATCH-GRAPH-CONSUMER-RX.md for design rationale.
- * See: packages/graph/docs/ARCHITECTURE.md for graph consumer context.
+ * See: packages/graph/docs/ARCHITECTURE.md for Weaver context.
  */
 
 interface BurstBufferOptions {
@@ -4588,7 +4670,7 @@ declare function burstBuffer<T>(options: BurstBufferOptions): OperatorFunction<T
  *
  * Use RxJS `groupBy(keyFn) + concatMap(...)` when the work arrives as an
  * **event stream** that a component subscribes to once at startup. This
- * is how `Smelter`, `GraphDBConsumer`, and `Gatherer` serialize their own
+ * is how `Smelter`, `Weaver`, and `Gatherer` serialize their own
  * per-resource work — see their implementations in `packages/make-meaning`.
  *
  * Both patterns solve the same logical problem ("serialize work per key").
@@ -4681,7 +4763,7 @@ declare function busLog(op: BusOp, channel: string, payload: unknown, scope?: st
  * Annotation body utilities
  *
  * These are the matcher primitives used by the `mark:body-updated` event
- * replay path (ViewMaterializer and GraphDBConsumer) to apply add/remove/
+ * replay path (ViewMaterializer and Weaver) to apply add/remove/
  * replace operations against an annotation body.
  */
 
@@ -5497,6 +5579,10 @@ declare const BUS_OPERATIONS: {
         readonly result: "match:search-results";
         readonly failure: "match:search-failed";
     };
+    readonly 'weave:rebuild': {
+        readonly result: "weave:rebuild-ok";
+        readonly failure: "weave:rebuild-failed";
+    };
     readonly 'yield:create': {
         readonly result: "yield:create-ok";
         readonly failure: "yield:create-failed";
@@ -7133,4 +7219,4 @@ interface GraphViews {
 declare function deriveViews(graph: KnowledgeGraph, mainResourceId: string, focalAnnotationId?: string): GraphViews;
 
 export { AUTHORABLE_MEDIA_TYPES, BRIDGED_CHANNELS, BusRequestError, CHANNEL_SCHEMAS, CONTEXT_FULL_WEIGHT, CONTEXT_PARTIAL_WEIGHT, ConfigurationError, ConflictError, EMBEDDABLE_MEDIA_TYPES, EventBus, JWTTokenSchema, LOCALES, MEDIA_TYPES, NotFoundError, PERSISTED_EVENT_TYPES, POSITION_WEIGHT_MAX, POSITION_WINDOW, RESOURCE_BROADCAST_TYPES, ScopedEventBus, ScriptError, SemiontError, UnauthorizedError, ValidationError, accessToken, agentToDid, anchorAnnotation, annotationId, annotationUri, applyBodyOperations, assembleAnnotation, authCode, baseMediaType, baseUrl, buildContentCache, burstBuffer, busLog, busLogEnabled, busRequest, capabilitiesOf, cloneToken, createCircleSvg, createFragmentSelector, createPolygonSvg, createRectangleSvg, createTomlConfigLoader, decodeRepresentation, decodeWithCharset, deriveViews, didToAgent, email, entityType, errField, extensionForMediaType, extractBoundingBox, extractCharset, extractContext, findBestTextMatch, findBodyItem, formatLocaleDisplay, generateUuid, getAllLocaleCodes, getAllPlatformTypes, getAnnotationExactText, getAnnotationUriFromEvent, getBodySource, getBodyType, getChecksum, getCommentText, getCreator, getDerivedFrom, getExactText, getFragmentSelector, getLanguage, getLocaleEnglishName, getLocaleInfo, getLocaleNativeName, getNodeEncoding, getPageFromFragment, getPrimaryMediaType, getPrimaryRepresentation, getPrimarySelector, getResourceEntityTypes, getResourceId, getStorageUri, getSvgSelector, getTargetSelector, getTargetSource, getTextPositionSelector, getTextQuoteSelector, googleCredential, hasTargetSelector, isAnnotationId, isArchived, isArray, isAssessment, isBodyResolved, isBoolean, isComment, isDefined, isDraft, isEventRelatedToAnnotation, isFunction, isHighlight, isNull, isNullish, isNumber, isObject, isReference, isResolvedReference, isResourceId, isStoredEvent, isString, isStubReference, isSupportedMediaType, isTag, isUndefined, isValidEmail, isValidPlatformType, jobId, loadTomlConfig, mcpToken, mediaTypeForExtension, normalizeCoordinates, normalizeText, parseEnvironment, parseFragmentSelector, parseSvgSelector, reconcileSelector, refreshToken, resourceAnnotationUri, resourceId, resourceUri, scaleSvgToNative, searchQuery, serializePerKey, setBusLogTraceIdProvider, softwareToAgent, textExtractionOf, userDID, userId, userToAgent, userToDid, validateData, validateEnvironment, validateSvgMarkup, verifyPosition };
-export type { AccessToken, AnchorConfidence, AnchorMethod, AnchorSelectors, AnchorStrategy, AnchoringModel, Annotation, AnnotationCategory, AnnotationId, AnnotationUri, AnthropicProviderConfig, AppConfig, AssembledAnnotation, AuthCode, BackendDownload, BackendServiceConfig, BaseUrl, BodyItem, BodyItemIdentity, BodyOperation, BoundingBox, Brand, BridgedChannel, BurstBufferOptions, BusOp, BusRequestErrorCode, BusRequestPrimitive, CloneToken, CollaboratorEntry, ConnectionState, ContentCache, ContentFormat, CreateAnnotationInternal, DatabaseServiceConfig, Email, EmbeddingServiceConfig, EmittableChannel, EntityType, EntityTypeStats, Environment, EnvironmentConfig, EventBase, EventInput, EventMap, EventMetadata, EventName, EventOfType, EventQuery, EventSignature, FragmentSelector, FrontendServiceConfig, GatheredContext, GoogleAuthRequest, GoogleCredential, GraphConnection, GraphDatabaseType, GraphPath, GraphServiceConfig, GraphViews, HealthCheckResponse, IBackendOperations, IContentTransport, ITransport, InferenceProvidersConfig, JobId, JobType, ListUsersResponse, LlmSelectorInput, LocaleInfo, Logger, MCPToken, MatchQuality, McpServiceConfig, MediaTypeCapabilities, Motivation, OllamaProviderConfig, PdfCoordinate, PersistedEvent, PersistedEventType, PlatformType, Point, ProgressCallback, ProgressEvent, PutBinaryOptions, PutBinaryProgress, PutBinaryRequest, ReconciledSelector, RefreshToken, RenderMode, RenderedAnchor, ResourceAnnotationUri, ResourceAnnotations, ResourceBroadcastType, ResourceDescriptor, ResourceFilter, ResourceId, ResourceUri, SearchQuery, SelectionData, Selector, SemiontConfig, ServicePlatformConfig, ServicesConfig, SiteConfig, StateUnit, StatusResponse, StoredEvent, StoredEventLike, SupportedMediaType, SvgSelector, TagCategory, TagSchema, TextExtraction, TextPosition, TextPositionSelector, TextQuoteSelector, ActorInferenceConfig as TomlActorInferenceConfig, TomlFileReader, InferenceConfig as TomlInferenceConfig, WorkerInferenceConfig as TomlWorkerInferenceConfig, TransportErrorCode, UpdateResourceInput, UpdateUserRequest, UpdateUserResponse, UserDID, UserId, UserResponse, ValidationFailure, ValidationResult, ValidationSuccess, VectorsServiceConfig, components, operations, paths };
+export type { AccessToken, AnchorConfidence, AnchorMethod, AnchorRect, AnchorSelectors, AnchorStrategy, AnchoringModel, Annotation, AnnotationCategory, AnnotationId, AnnotationUri, AnthropicProviderConfig, AppConfig, AssembledAnnotation, AuthCode, BackendDownload, BackendServiceConfig, BaseUrl, BodyItem, BodyItemIdentity, BodyOperation, BoundingBox, Brand, BridgedChannel, BurstBufferOptions, BusOp, BusRequestErrorCode, BusRequestPrimitive, CloneToken, CollaboratorEntry, ConnectionState, ContentCache, ContentFormat, CreateAnnotationInternal, DatabaseServiceConfig, Email, EmbeddingServiceConfig, EmittableChannel, EntityType, EntityTypeStats, Environment, EnvironmentConfig, EventBase, EventInput, EventMap, EventMetadata, EventName, EventOfType, EventQuery, EventSignature, FragmentSelector, FrontendServiceConfig, GatheredContext, GoogleAuthRequest, GoogleCredential, GraphConnection, GraphDatabaseType, GraphPath, GraphServiceConfig, GraphViews, HealthCheckResponse, IBackendOperations, IContentTransport, ITransport, InferenceProvidersConfig, JobId, JobType, ListUsersResponse, LlmSelectorInput, LocaleInfo, Logger, MCPToken, MatchQuality, McpServiceConfig, MediaTypeCapabilities, Motivation, OllamaProviderConfig, PdfCoordinate, PersistedEvent, PersistedEventType, PlatformType, Point, ProgressCallback, ProgressEvent, PutBinaryOptions, PutBinaryProgress, PutBinaryRequest, ReconciledSelector, RefreshToken, RenderMode, RenderedAnchor, ResourceAnnotationUri, ResourceAnnotations, ResourceBroadcastType, ResourceDescriptor, ResourceFilter, ResourceId, ResourceUri, SearchQuery, SelectionData, Selector, SemiontConfig, ServicePlatformConfig, ServicesConfig, SiteConfig, StateUnit, StatusResponse, StoredEvent, StoredEventLike, SupportedMediaType, SvgSelector, TagCategory, TagSchema, TextExtraction, TextPosition, TextPositionSelector, TextQuoteSelector, ActorInferenceConfig as TomlActorInferenceConfig, TomlFileReader, InferenceConfig as TomlInferenceConfig, WorkerInferenceConfig as TomlWorkerInferenceConfig, TransportErrorCode, UpdateResourceInput, UpdateUserRequest, UpdateUserResponse, UserDID, UserId, UserResponse, ValidationFailure, ValidationResult, ValidationSuccess, VectorsServiceConfig, components, operations, paths };

package/dist/index.js

@@ -265,12 +265,14 @@ var CHANNEL_SCHEMAS = {
   "browse:directory-result": "BrowseDirectoryResult",
   "browse:directory-failed": null,
   // { correlationId; path } & CommandError
-  "browse:click": "BrowseClickEvent",
+  "browse:click": null,
+  // includes runtime `anchorRect?: AnchorRect`
   "browse:reference-navigate": "BrowseReferenceNavigateEvent",
   "browse:entity-type-clicked": "BrowseEntityTypeClickedEvent",
   // ── SHELL (app-scoped UI events, fire on SemiontBrowser bus) ────
   "panel:toggle": "BrowsePanelToggleEvent",
-  "panel:open": "BrowsePanelOpenEvent",
+  "panel:open": null,
+  // includes runtime `anchorRect?: AnchorRect`
   "panel:close": null,
   // void
   "shell:sidebar-toggle": null,
@@ -316,6 +318,16 @@ var CHANNEL_SCHEMAS = {
   // void
   "settings:locale-changed": "SettingsLocaleChangedEvent",
   "settings:hover-delay-changed": "SettingsHoverDelayChangedEvent",
+  // ── WEAVE FLOW ──────────────────────────────────────────────────
+  "weave:applied": null,
+  // { resourceId; sequenceNumber }
+  "smelt:settled": null,
+  // { resourceId; contentChecksum; outcome }
+  "weave:rebuild": "WeaveRebuildCommand",
+  "weave:rebuild-ok": null,
+  // { correlationId }
+  "weave:rebuild-failed": null,
+  // { correlationId; message }
   // ── SSE infrastructure ──────────────────────────────────────────
   "stream-connected": null,
   // Record<string, never>
@@ -394,6 +406,9 @@ var BUS_OPERATIONS = {
   // ── MATCH ───────────────────────────────────────────────────────
   // take-1 dressed as an Observable in the SDK; no progress channel
   "match:search-requested": { result: "match:search-results", failure: "match:search-failed" },
+  // ── WEAVE ───────────────────────────────────────────────────────
+  // Graph-projection rebuild, served by the Weaver (WEAVER-ISOLATION D3)
+  "weave:rebuild": { result: "weave:rebuild-ok", failure: "weave:rebuild-failed" },
   // ── YIELD ───────────────────────────────────────────────────────
   // live in-process (resource-operations.ts emits + awaits via race()); the
   // client also .on()-subscribes -ok for cache invalidation