@semiont/core 0.5.10 → 0.5.11

package/dist/index.d.ts

@@ -2295,8 +2295,7 @@ interface components {
         };
         JobStatusResponse: {
             jobId: string;
-            /** @enum {string} */
-            type: "reference-annotation" | "generation" | "highlight-annotation" | "assessment-annotation" | "comment-annotation" | "tag-annotation";
+            type: components["schemas"]["JobType"];
             /** @enum {string} */
             status: "pending" | "running" | "complete" | "failed" | "cancelled";
             userId: string;
@@ -2651,6 +2650,17 @@ interface components {
          * @enum {string}
          */
         BodyPurpose: "assessing" | "bookmarking" | "classifying" | "commenting" | "describing" | "editing" | "highlighting" | "identifying" | "linking" | "moderating" | "questioning" | "replying" | "tagging";
+        /** @description Request to browse the KB's collaborator directory (its declared Agents) */
+        BrowseAgentsRequest: {
+            correlationId: string;
+        };
+        /** @description Result of browsing the collaborator directory */
+        BrowseAgentsResult: {
+            correlationId: string;
+            response: {
+                agents: components["schemas"]["CollaboratorEntry"][];
+            };
+        };
         /** @description Request to browse the history of an annotation */
         BrowseAnnotationHistoryRequest: {
             correlationId: string;
@@ -2819,6 +2829,12 @@ interface components {
             correlationId: string;
             response: components["schemas"]["GetTagSchemasResponse"];
         };
+        /** @description One collaborator in the KB's directory: a W3C Agent plus, for software agents declared in the KB's worker inference config, the job types it serves. Actor-role-only agents (gatherer/matcher) and Persons omit servesJobTypes. */
+        CollaboratorEntry: {
+            agent: components["schemas"]["Agent"];
+            /** @description Job types this agent is declared to serve (from the KB's workers.* config sections). Absent for Persons and for agents declared only under actor roles. */
+            servesJobTypes?: components["schemas"]["JobType"][];
+        };
         /** @description W3C Web Annotation FragmentSelector for media fragment identifiers (RFC 3778 for PDFs) */
         FragmentSelector: {
             /** @enum {string} */
@@ -2988,8 +3004,7 @@ interface components {
             correlationId: string;
             /** @description Authenticated user's DID, injected by the /bus/emit gateway. Clients do not set this. */
             _userId?: string;
-            /** @enum {string} */
-            jobType: "reference-annotation" | "highlight-annotation" | "assessment-annotation" | "comment-annotation" | "tag-annotation" | "generation";
+            jobType: components["schemas"]["JobType"];
             resourceId: string;
             params: {
                 [key: string]: unknown;
@@ -3182,10 +3197,6 @@ interface components {
                 categories?: string[];
             };
         };
-        /** @description Emitted when the mark click action changes */
-        MarkClickChangedEvent: {
-            action: string;
-        };
         /** @description Bus command to create an annotation on a resource. */
         MarkCreateCommand: {
             /** @description Authenticated user's DID, injected by the /bus/emit gateway. Clients do not set this. */
@@ -3230,20 +3241,16 @@ interface components {
         };
         /** @description Emitted when the user requests a new mark (annotation) on a resource */
         MarkRequestedEvent: {
+            /** @description The '@id' of the resource the mark belongs to (W3C target.source). Routes the event to the right viewer/state unit when a host mounts many viewers on one session. */
+            source: string;
             /** @description One or more W3C selectors */
             selector: components["schemas"]["TextPositionSelector"] | components["schemas"]["TextQuoteSelector"] | components["schemas"]["SvgSelector"] | components["schemas"]["FragmentSelector"] | (components["schemas"]["TextPositionSelector"] | components["schemas"]["TextQuoteSelector"] | components["schemas"]["SvgSelector"] | components["schemas"]["FragmentSelector"])[];
             motivation: components["schemas"]["Motivation"];
         };
-        /** @description Emitted when the active mark selection changes */
-        MarkSelectionChangedEvent: {
-            motivation: string | null;
-        };
-        /** @description Emitted when the mark shape changes */
-        MarkShapeChangedEvent: {
-            shape: string;
-        };
         /** @description Emitted when a mark is submitted with its annotation body */
         MarkSubmitEvent: {
+            /** @description The '@id' of the resource the mark belongs to (W3C target.source). Routes the submit to the state unit bound to that resource — without it, N mounted units each create the annotation (N copies on N resources). */
+            source: string;
             motivation: components["schemas"]["Motivation"];
             /** @description One or more W3C selectors */
             selector: components["schemas"]["TextPositionSelector"] | components["schemas"]["TextQuoteSelector"] | components["schemas"]["SvgSelector"] | components["schemas"]["FragmentSelector"] | (components["schemas"]["TextPositionSelector"] | components["schemas"]["TextQuoteSelector"] | components["schemas"]["SvgSelector"] | components["schemas"]["FragmentSelector"])[];
@@ -3271,6 +3278,8 @@ interface components {
         };
         /** @description Bus command to replace the entity types on a resource. */
         MarkUpdateEntityTypesCommand: {
+            /** @description Correlation id for request/reply matching, set by the SDK's busRequest so the confirmed-write ack/failure routes back. */
+            correlationId?: string;
             resourceId: string;
             /** @description Authenticated user's DID, injected by the /bus/emit gateway. Clients do not set this. */
             _userId?: string;
@@ -3841,6 +3850,10 @@ type EventMap = {
         correlationId?: string;
     };
     'mark:unarchive-failed': components['schemas']['CommandError'];
+    'mark:update-entity-types-ok': {
+        correlationId?: string;
+    };
+    'mark:update-entity-types-failed': components['schemas']['CommandError'];
     'mark:body-update-failed': components['schemas']['CommandError'];
     'mark:select-comment': components['schemas']['SelectionData'];
     'mark:select-tag': components['schemas']['SelectionData'];
@@ -3852,10 +3865,6 @@ type EventMap = {
     'mark:assist-request': components['schemas']['MarkAssistRequestEvent'];
     'mark:assist-cancelled': void;
     'mark:progress-dismiss': void;
-    'mark:mode-toggled': void;
-    'mark:selection-changed': components['schemas']['MarkSelectionChangedEvent'];
-    'mark:click-changed': components['schemas']['MarkClickChangedEvent'];
-    'mark:shape-changed': components['schemas']['MarkShapeChangedEvent'];
     'frame:entity-type-added': StoredEvent<EventOfType<'frame:entity-type-added'>>;
     'frame:tag-schema-added': StoredEvent<EventOfType<'frame:tag-schema-added'>>;
     'frame:add-entity-type': components['schemas']['FrameAddEntityTypeCommand'];
@@ -3949,6 +3958,11 @@ type EventMap = {
     'browse:tag-schemas-failed': {
         correlationId: string;
     } & components['schemas']['CommandError'];
+    'browse:agents-requested': components['schemas']['BrowseAgentsRequest'];
+    'browse:agents-result': components['schemas']['BrowseAgentsResult'];
+    'browse:agents-failed': {
+        correlationId: string;
+    } & components['schemas']['CommandError'];
     'browse:directory-requested': components['schemas']['BrowseDirectoryRequest'];
     'browse:directory-result': components['schemas']['BrowseDirectoryResult'];
     'browse:directory-failed': {
@@ -4147,6 +4161,8 @@ declare const CHANNEL_SCHEMAS: {
     readonly 'mark:archive-failed': "CommandError";
     readonly 'mark:unarchive-ok': null;
     readonly 'mark:unarchive-failed': "CommandError";
+    readonly 'mark:update-entity-types-ok': null;
+    readonly 'mark:update-entity-types-failed': "CommandError";
     readonly 'mark:body-update-failed': "CommandError";
     readonly 'frame:entity-type-add-ok': null;
     readonly 'frame:entity-type-add-failed': "CommandError";
@@ -4162,10 +4178,6 @@ declare const CHANNEL_SCHEMAS: {
     readonly 'mark:assist-request': "MarkAssistRequestEvent";
     readonly 'mark:assist-cancelled': null;
     readonly 'mark:progress-dismiss': null;
-    readonly 'mark:mode-toggled': null;
-    readonly 'mark:selection-changed': "MarkSelectionChangedEvent";
-    readonly 'mark:click-changed': "MarkClickChangedEvent";
-    readonly 'mark:shape-changed': "MarkShapeChangedEvent";
     readonly 'bind:initiate': "BindInitiateCommand";
     readonly 'bind:update-body': "BindUpdateBodyCommand";
     readonly 'bind:body-updated': "BindBodyUpdated";
@@ -4213,6 +4225,9 @@ declare const CHANNEL_SCHEMAS: {
     readonly 'browse:tag-schemas-requested': "BrowseTagSchemasRequest";
     readonly 'browse:tag-schemas-result': "BrowseTagSchemasResult";
     readonly 'browse:tag-schemas-failed': null;
+    readonly 'browse:agents-requested': "BrowseAgentsRequest";
+    readonly 'browse:agents-result': "BrowseAgentsResult";
+    readonly 'browse:agents-failed': null;
     readonly 'browse:directory-requested': "BrowseDirectoryRequest";
     readonly 'browse:directory-result': "BrowseDirectoryResult";
     readonly 'browse:directory-failed': null;
@@ -4280,6 +4295,14 @@ type EmittableChannel = {
 type Selector = components['schemas']['TextPositionSelector'] | components['schemas']['TextQuoteSelector'] | components['schemas']['SvgSelector'] | components['schemas']['FragmentSelector'];
 type GatheredContext = components['schemas']['GatheredContext'];
 type SelectionData = components['schemas']['SelectionData'];
+type JobType = components['schemas']['JobType'];
+/**
+ * One entry of the collaborator directory (`browse:agents-result`): a typed
+ * `Agent` plus, for software agents drawn from the KB's worker config, the
+ * job types it serves. Persons and actor-role-only agents omit
+ * `servesJobTypes`. See .plans/COLLABORATOR-DIRECTORY.md.
+ */
+type CollaboratorEntry = components['schemas']['CollaboratorEntry'];
 
 /**
  * Event Type Guards and Extraction Utilities
@@ -5401,6 +5424,10 @@ declare const BUS_OPERATIONS: {
         readonly result: "browse:tag-schemas-result";
         readonly failure: "browse:tag-schemas-failed";
     };
+    readonly 'browse:agents-requested': {
+        readonly result: "browse:agents-result";
+        readonly failure: "browse:agents-failed";
+    };
     readonly 'browse:directory-requested': {
         readonly result: "browse:directory-result";
         readonly failure: "browse:directory-failed";
@@ -5462,6 +5489,10 @@ declare const BUS_OPERATIONS: {
         readonly result: "mark:unarchive-ok";
         readonly failure: "mark:unarchive-failed";
     };
+    readonly 'mark:update-entity-types': {
+        readonly result: "mark:update-entity-types-ok";
+        readonly failure: "mark:update-entity-types-failed";
+    };
     readonly 'match:search-requested': {
         readonly result: "match:search-results";
         readonly failure: "match:search-failed";
@@ -7102,4 +7133,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, 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, 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, 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

@@ -181,6 +181,8 @@ var CHANNEL_SCHEMAS = {
   "mark:archive-failed": "CommandError",
   "mark:unarchive-ok": null,
   "mark:unarchive-failed": "CommandError",
+  "mark:update-entity-types-ok": null,
+  "mark:update-entity-types-failed": "CommandError",
   "mark:body-update-failed": "CommandError",
   "frame:entity-type-add-ok": null,
   "frame:entity-type-add-failed": "CommandError",
@@ -199,11 +201,6 @@ var CHANNEL_SCHEMAS = {
   // void
   "mark:progress-dismiss": null,
   // void
-  "mark:mode-toggled": null,
-  // void
-  "mark:selection-changed": "MarkSelectionChangedEvent",
-  "mark:click-changed": "MarkClickChangedEvent",
-  "mark:shape-changed": "MarkShapeChangedEvent",
   // ── BIND FLOW ───────────────────────────────────────────────────
   "bind:initiate": "BindInitiateCommand",
   "bind:update-body": "BindUpdateBodyCommand",
@@ -261,6 +258,9 @@ var CHANNEL_SCHEMAS = {
   "browse:tag-schemas-requested": "BrowseTagSchemasRequest",
   "browse:tag-schemas-result": "BrowseTagSchemasResult",
   "browse:tag-schemas-failed": null,
+  "browse:agents-requested": "BrowseAgentsRequest",
+  "browse:agents-result": "BrowseAgentsResult",
+  "browse:agents-failed": null,
   "browse:directory-requested": "BrowseDirectoryRequest",
   "browse:directory-result": "BrowseDirectoryResult",
   "browse:directory-failed": null,
@@ -366,6 +366,7 @@ var BUS_OPERATIONS = {
   "browse:referenced-by-requested": { result: "browse:referenced-by-result", failure: "browse:referenced-by-failed" },
   "browse:entity-types-requested": { result: "browse:entity-types-result", failure: "browse:entity-types-failed" },
   "browse:tag-schemas-requested": { result: "browse:tag-schemas-result", failure: "browse:tag-schemas-failed" },
+  "browse:agents-requested": { result: "browse:agents-result", failure: "browse:agents-failed" },
   "browse:directory-requested": { result: "browse:directory-result", failure: "browse:directory-failed" },
   // dormant — backend handler complete, no client caller yet (annotation-detail capability)
   "browse:annotation-context-requested": { result: "browse:annotation-context-result", failure: "browse:annotation-context-failed" },
@@ -389,6 +390,7 @@ var BUS_OPERATIONS = {
   "mark:delete": { result: "mark:delete-ok", failure: "mark:delete-failed" },
   "mark:archive": { result: "mark:archive-ok", failure: "mark:archive-failed" },
   "mark:unarchive": { result: "mark:unarchive-ok", failure: "mark:unarchive-failed" },
+  "mark:update-entity-types": { result: "mark:update-entity-types-ok", failure: "mark:update-entity-types-failed" },
   // ── MATCH ───────────────────────────────────────────────────────
   // take-1 dressed as an Observable in the SDK; no progress channel
   "match:search-requested": { result: "match:search-results", failure: "match:search-failed" },
@@ -1200,7 +1202,13 @@ async function busRequest(bus, operation, payload, timeoutMs = 3e4) {
     })
   );
   const resultPromise = firstValueFrom(result$);
-  await bus.emit(operation, fullPayload);
+  try {
+    await bus.emit(operation, fullPayload);
+  } catch (emitError) {
+    resultPromise.catch(() => {
+    });
+    throw emitError;
+  }
   const result = await resultPromise;
   if (!result.ok) {
     throw result.error;