@semiont/core 0.4.7 → 0.4.9

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { Subject, OperatorFunction } from 'rxjs';
-import { E as EnvironmentConfig, P as PlatformType$1 } from './config.types-D3ReOdqd.js';
-export { A as AnthropicProviderConfig, a as AppConfig, B as BackendServiceConfig, D as DatabaseServiceConfig, F as FrontendServiceConfig, G as GraphDatabaseType, b as GraphServiceConfig, I as InferenceProvidersConfig, M as McpServiceConfig, O as OllamaProviderConfig, c as ProxyServiceConfig, S as SemiontConfig, d as ServicePlatformConfig, e as ServicesConfig, f as SiteConfig } from './config.types-D3ReOdqd.js';
+import { E as EnvironmentConfig, P as PlatformType$1 } from './config.types-kPA59Jjb.js';
+export { A as AnthropicProviderConfig, a as AppConfig, B as BackendServiceConfig, D as DatabaseServiceConfig, F as FrontendServiceConfig, G as GraphDatabaseType, b as GraphServiceConfig, I as InferenceProvidersConfig, M as McpServiceConfig, O as OllamaProviderConfig, c as ProxyServiceConfig, S as SemiontConfig, d as ServicePlatformConfig, e as ServicesConfig, f as SiteConfig } from './config.types-kPA59Jjb.js';
 
 /**
  * This file was auto-generated by openapi-typescript.
@@ -566,6 +566,58 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/tokens/media": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Generate Media Token
+         * @description Generate a short-lived, resource-scoped media token for use as a ?token= query parameter on binary resource URLs (images, PDFs). Requires session authentication.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["MediaTokenRequest"];
+                };
+            };
+            responses: {
+                /** @description Media token generated */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["MediaTokenResponse"];
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/users/me": {
         parameters: {
             query?: never;
@@ -1781,6 +1833,73 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/resources/{id}/match-search-stream": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Match Search (SSE Stream)
+         * @description Search for binding candidates for a reference annotation via Server-Sent Events. Delegates to the Matcher actor on the backend EventBus.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Resource ID */
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["MatchSearchStreamRequest"];
+                };
+            };
+            responses: {
+                /** @description SSE stream opened successfully */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "text/event-stream": components["schemas"]["EventStreamResponse"];
+                    };
+                };
+                /** @description referenceId and context are required */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Resource not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/resources/{resourceId}/annotations/{annotationId}/gather-annotation-stream": {
         parameters: {
             query?: never;
@@ -3200,6 +3319,8 @@ interface components {
             includeDescriptiveReferences?: boolean;
         };
         GatherResourceStreamRequest: {
+            /** @description Client-generated correlation ID to thread the response back to the originating request */
+            correlationId?: string;
             /** @description Graph traversal depth (default: 2) */
             depth?: number;
             /** @description Maximum related resources to include (default: 10) */
@@ -3210,6 +3331,8 @@ interface components {
             includeSummary?: boolean;
         };
         GatherAnnotationStreamRequest: {
+            /** @description Client-generated correlation ID to thread the response back to the originating request */
+            correlationId?: string;
             /** @description Characters of surrounding text context (default: 1000) */
             contextWindow?: number;
         };
@@ -3741,6 +3864,7 @@ interface components {
             domain: string;
             provider: string;
             isAdmin: boolean;
+            isModerator: boolean;
             isActive: boolean;
             termsAcceptedAt: string | null;
             lastLogin: string | null;
@@ -3774,6 +3898,14 @@ interface components {
          * @enum {string}
          */
         BodyPurpose: "assessing" | "bookmarking" | "classifying" | "commenting" | "describing" | "editing" | "highlighting" | "identifying" | "linking" | "moderating" | "questioning" | "replying" | "tagging";
+        MediaTokenRequest: {
+            /** @description The resource ID to generate a media token for */
+            resourceId: string;
+        };
+        MediaTokenResponse: {
+            /** @description Short-lived media token for use as ?token= query parameter on resource URLs */
+            token: string;
+        };
         /** @description Context gathered for an annotation. Includes source document excerpts, metadata, and graph-derived context. Used by both Find (bind) and Generate (yield) flows. */
         GatheredContext: {
             /** @description The annotation this context was gathered for */
@@ -3830,6 +3962,18 @@ interface components {
                 inferredRelationshipSummary?: string;
             };
         };
+        MatchSearchStreamRequest: {
+            /** @description Client-generated correlation ID to thread the response back to the originating request */
+            correlationId?: string;
+            /** @description Annotation ID of the reference to search candidates for */
+            referenceId: string;
+            /** @description Gathered context for the reference annotation */
+            context: components["schemas"]["GatheredContext"];
+            /** @description Maximum number of candidate results to return (default: 10) */
+            limit?: number;
+            /** @description Enable semantic similarity scoring in addition to keyword matching (default: true) */
+            useSemanticScoring?: boolean;
+        };
     };
     responses: never;
     parameters: never;
@@ -4259,6 +4403,27 @@ interface ResourceAnnotations {
  * No React dependencies - safe to use in any JavaScript environment.
  */
 
+/**
+ * Minimal event shape accepted by event utility functions.
+ * Compatible with both the internal `StoredEvent` type and the OpenAPI-derived
+ * schema type (`GetEventsResponse['events'][number]`), which lacks `version`
+ * on the inner event.
+ */
+interface StoredEventLike {
+    event: {
+        id: string;
+        type: string;
+        timestamp: string;
+        userId: string;
+        resourceId?: string;
+        payload?: unknown;
+    };
+    metadata: {
+        sequenceNumber: number;
+        prevEventHash?: string;
+        checksum?: string;
+    };
+}
 /**
  * Extract annotation ID from event payload
  * Returns null if event is not annotation-related
@@ -4266,11 +4431,11 @@ interface ResourceAnnotations {
  * For annotation.added: extracts full URI from payload.annotation.id
  * For annotation.removed/body.updated: constructs full URI from payload.annotationId (UUID) + resourceId
  */
-declare function getAnnotationUriFromEvent(event: StoredEvent): AnnotationUri | null;
+declare function getAnnotationUriFromEvent(event: StoredEventLike): AnnotationUri | null;
 /**
  * Check if an event is related to a specific annotation
  */
-declare function isEventRelatedToAnnotation(event: StoredEvent, annotationUri: AnnotationUri): boolean;
+declare function isEventRelatedToAnnotation(event: StoredEventLike, annotationUri: AnnotationUri): boolean;
 /**
  * Type guard to check if event is a resource event
  */
@@ -4373,7 +4538,11 @@ type EventMap = {
     'yield:progress': YieldProgress;
     'yield:finished': YieldProgress;
     'yield:failed': {
-        error: Error;
+        error?: Error | string;
+        status?: string;
+        referenceId?: string;
+        percentage?: number;
+        message?: string;
     };
     'yield:representation-added': Extract<ResourceEvent, {
         type: 'representation.added';
@@ -4536,15 +4705,24 @@ type EventMap = {
             categories?: string[];
         };
     };
-    'mark:progress': MarkProgress;
+    'mark:progress': MarkProgress & {
+        resourceId?: ResourceId;
+    };
     'mark:assist-finished': {
         motivation?: Motivation;
         resourceId?: ResourceId;
+        status?: string;
+        percentage?: number;
+        foundCount?: number;
+        createdCount?: number;
+        byCategory?: Record<string, number>;
+        message?: string;
         progress?: MarkProgress;
     };
-    'mark:assist-failed': Extract<ResourceEvent, {
-        type: 'job.failed';
-    }>;
+    'mark:assist-failed': {
+        resourceId?: ResourceId;
+        message?: string;
+    };
     'mark:assist-cancelled': void;
     'mark:progress-dismiss': void;
     'mark:mode-toggled': void;
@@ -4636,27 +4814,27 @@ type EventMap = {
         error: Error;
     };
     'match:search-requested': {
-        correlationId?: string;
+        correlationId: string;
         referenceId: string;
         context: GatheredContext;
         limit?: number;
         useSemanticScoring?: boolean;
     };
     'match:search-results': {
+        correlationId: string;
         referenceId: string;
-        results: Array<components['schemas']['ResourceDescriptor'] & {
+        response: Array<components['schemas']['ResourceDescriptor'] & {
             score?: number;
             matchReason?: string;
         }>;
-        correlationId?: string;
     };
     'match:search-failed': {
+        correlationId: string;
         referenceId: string;
-        error: Error;
-        correlationId?: string;
+        error: string;
     };
     'gather:requested': {
-        correlationId?: string;
+        correlationId: string;
         annotationId: AnnotationId;
         resourceId: ResourceId;
         options?: {
@@ -4666,12 +4844,12 @@ type EventMap = {
         };
     };
     'gather:complete': {
-        correlationId?: string;
+        correlationId: string;
         annotationId: AnnotationId;
         response: components['schemas']['AnnotationLLMContextResponse'];
     };
     'gather:failed': {
-        correlationId?: string;
+        correlationId: string;
         annotationId: AnnotationId;
         error: Error;
     };
@@ -4680,12 +4858,12 @@ type EventMap = {
         percentage?: number;
     };
     'gather:annotation-finished': {
-        correlationId?: string;
+        correlationId: string;
         annotationId: AnnotationId;
         response: components['schemas']['AnnotationLLMContextResponse'];
     };
     'gather:resource-requested': {
-        correlationId?: string;
+        correlationId: string;
         resourceId: ResourceId;
         options: {
             depth: number;
@@ -4695,12 +4873,12 @@ type EventMap = {
         };
     };
     'gather:resource-complete': {
-        correlationId?: string;
+        correlationId: string;
         resourceId: ResourceId;
-        context: components['schemas']['ResourceLLMContextResponse'];
+        response: components['schemas']['ResourceLLMContextResponse'];
     };
     'gather:resource-failed': {
-        correlationId?: string;
+        correlationId: string;
         resourceId: ResourceId;
         error: Error;
     };
@@ -4709,9 +4887,9 @@ type EventMap = {
         percentage?: number;
     };
     'gather:finished': {
-        correlationId?: string;
+        correlationId: string;
         resourceId: ResourceId;
-        context: components['schemas']['ResourceLLMContextResponse'];
+        response: components['schemas']['ResourceLLMContextResponse'];
     };
     'browse:click': {
         annotationId: string;
@@ -4955,6 +5133,7 @@ type EventMap = {
     'settings:hover-delay-changed': {
         hoverDelayMs: number;
     };
+    'stream-connected': Record<string, never>;
 };
 /**
  * Union type of all valid event names
@@ -5482,13 +5661,13 @@ type TomlFileReader = {
  * @param reader - File reader abstraction
  * @param env - Environment variables for ${VAR} resolution
  */
-declare function loadTomlConfig(projectRoot: string, environment: string, globalConfigPath: string, reader: TomlFileReader, env: Record<string, string | undefined>): EnvironmentConfig;
+declare function loadTomlConfig(projectRoot: string | null, environment: string, globalConfigPath: string, reader: TomlFileReader, env: Record<string, string | undefined>): EnvironmentConfig;
 /**
  * Create a TOML config loader backed by a file reader.
  * Drop-in replacement for createConfigLoader that reads TOML instead of JSON.
  * The caller must resolve globalConfigPath (e.g. expand '~' using process.env.HOME).
  */
-declare function createTomlConfigLoader(reader: TomlFileReader, globalConfigPath: string, env: Record<string, string | undefined>): (projectRoot: string, environment: string) => EnvironmentConfig;
+declare function createTomlConfigLoader(reader: TomlFileReader, globalConfigPath: string, env: Record<string, string | undefined>): (projectRoot: string | null, environment: string) => EnvironmentConfig;
 
 /**
  * Environment validation utilities
@@ -5565,4 +5744,4 @@ declare function getAllPlatformTypes(): PlatformType[];
 declare const CORE_TYPES_VERSION = "0.1.0";
 declare const SDK_VERSION = "0.1.0";
 
-export { APIError, type AccessToken, type AnnotationAddedEvent, type AnnotationBodyUpdatedEvent, type AnnotationCategory, type AnnotationId, type AnnotationRemovedEvent, type AnnotationUri, type AssembledAnnotation, type AuthCode, type BaseEvent, type BaseUrl, type BodyItem, type BodyOperation, type BurstBufferOptions, CORE_TYPES_VERSION, CREATION_METHODS, type CloneToken, ConfigurationError, ConflictError, type ContentFormat$1 as ContentFormat, type CreateAnnotationInternal, type CreationMethod, type Email, type EntityTagAddedEvent, type EntityTagRemovedEvent, type EntityType, type EntityTypeStats, type Environment, EnvironmentConfig, EventBus, type EventMap, type EventMetadata, type EventName, type EventQuery, type EventSignature, type GatheredContext, type GoogleAuthRequest, type GoogleCredential, type GraphConnection, type GraphPath, type JobCompletedEvent, type JobFailedEvent, type JobId, type JobProgressEvent, type JobStartedEvent, type Logger, type MCPToken, type MarkProgress, type Motivation$2 as Motivation, NotFoundError, type PlatformType, type RefreshToken, type RepresentationAddedEvent, type RepresentationRemovedEvent, type ResourceAnnotationUri, type ResourceAnnotations, type ResourceArchivedEvent, type ResourceClonedEvent, type ResourceCreatedEvent, type ResourceEvent, type ResourceEventType, type ResourceFilter, type ResourceId, type ResourceScopedEvent, type ResourceUnarchivedEvent, type ResourceUri, SDK_VERSION, ScopedEventBus, ScriptError, type SearchQuery, type SelectionData, type Selector, SemiontError, type StoredEvent, type SystemEvent, type ActorInferenceConfig as TomlActorInferenceConfig, type TomlFileReader, type InferenceConfig as TomlInferenceConfig, type WorkerInferenceConfig as TomlWorkerInferenceConfig, UnauthorizedError, type UpdateResourceInput, type UserDID, type UserId, ValidationError, type YieldProgress, accessToken, annotationId, annotationUri, applyBodyOperations, assembleAnnotation, authCode, baseUrl, burstBuffer, cloneToken, type components, createTomlConfigLoader, didToAgent, email, entityType, findBodyItem, generateUuid, getAllPlatformTypes, getAnnotationUriFromEvent, getEventType, getFragmentSelector, getSvgSelector, getTextPositionSelector, googleCredential, isAnnotationId, isArray, isBoolean, isDefined, isEventRelatedToAnnotation, isFunction, isNull, isNullish, isNumber, isObject, isResourceEvent$1 as isResourceEvent, isResourceId, isResourceScopedEvent, isResourceEvent as isStoredEvent, isString, isSystemEvent, isUndefined, isValidPlatformType, jobId, loadTomlConfig, mcpToken, type operations, parseEnvironment, type paths, refreshToken, resourceAnnotationUri, resourceId, resourceUri, searchQuery, userDID, userId, userToAgent, userToDid, validateEnvironment, validateSvgMarkup };
+export { APIError, type AccessToken, type AnnotationAddedEvent, type AnnotationBodyUpdatedEvent, type AnnotationCategory, type AnnotationId, type AnnotationRemovedEvent, type AnnotationUri, type AssembledAnnotation, type AuthCode, type BaseEvent, type BaseUrl, type BodyItem, type BodyOperation, type BurstBufferOptions, CORE_TYPES_VERSION, CREATION_METHODS, type CloneToken, ConfigurationError, ConflictError, type ContentFormat$1 as ContentFormat, type CreateAnnotationInternal, type CreationMethod, type Email, type EntityTagAddedEvent, type EntityTagRemovedEvent, type EntityType, type EntityTypeStats, type Environment, EnvironmentConfig, EventBus, type EventMap, type EventMetadata, type EventName, type EventQuery, type EventSignature, type GatheredContext, type GoogleAuthRequest, type GoogleCredential, type GraphConnection, type GraphPath, type JobCompletedEvent, type JobFailedEvent, type JobId, type JobProgressEvent, type JobStartedEvent, type Logger, type MCPToken, type MarkProgress, type Motivation$2 as Motivation, NotFoundError, type PlatformType, type RefreshToken, type RepresentationAddedEvent, type RepresentationRemovedEvent, type ResourceAnnotationUri, type ResourceAnnotations, type ResourceArchivedEvent, type ResourceClonedEvent, type ResourceCreatedEvent, type ResourceEvent, type ResourceEventType, type ResourceFilter, type ResourceId, type ResourceScopedEvent, type ResourceUnarchivedEvent, type ResourceUri, SDK_VERSION, ScopedEventBus, ScriptError, type SearchQuery, type SelectionData, type Selector, SemiontError, type StoredEvent, type StoredEventLike, type SystemEvent, type ActorInferenceConfig as TomlActorInferenceConfig, type TomlFileReader, type InferenceConfig as TomlInferenceConfig, type WorkerInferenceConfig as TomlWorkerInferenceConfig, UnauthorizedError, type UpdateResourceInput, type UserDID, type UserId, ValidationError, type YieldProgress, accessToken, annotationId, annotationUri, applyBodyOperations, assembleAnnotation, authCode, baseUrl, burstBuffer, cloneToken, type components, createTomlConfigLoader, didToAgent, email, entityType, findBodyItem, generateUuid, getAllPlatformTypes, getAnnotationUriFromEvent, getEventType, getFragmentSelector, getSvgSelector, getTextPositionSelector, googleCredential, isAnnotationId, isArray, isBoolean, isDefined, isEventRelatedToAnnotation, isFunction, isNull, isNullish, isNumber, isObject, isResourceEvent$1 as isResourceEvent, isResourceId, isResourceScopedEvent, isResourceEvent as isStoredEvent, isString, isSystemEvent, isUndefined, isValidPlatformType, jobId, loadTomlConfig, mcpToken, type operations, parseEnvironment, type paths, refreshToken, resourceAnnotationUri, resourceId, resourceUri, searchQuery, userDID, userId, userToAgent, userToDid, validateEnvironment, validateSvgMarkup };

package/dist/index.js

@@ -111,15 +111,16 @@ function getEventType(event) {
 // src/event-utils.ts
 function getAnnotationUriFromEvent(event) {
   const eventData = event.event;
+  const payload = eventData.payload;
   if (eventData.type === "annotation.added") {
-    return eventData.payload.annotation.id || null;
+    return payload?.annotation?.id || null;
   }
   if (eventData.type === "annotation.removed" || eventData.type === "annotation.body.updated") {
-    if (eventData.payload.annotationId && eventData.resourceId) {
+    if (payload?.annotationId && eventData.resourceId) {
       try {
         const resourceUri2 = eventData.resourceId;
         const baseUrl2 = resourceUri2.substring(0, resourceUri2.lastIndexOf("/resources/"));
-        return `${baseUrl2}/annotations/${eventData.payload.annotationId}`;
+        return `${baseUrl2}/annotations/${payload.annotationId}`;
       } catch (e) {
         return null;
       }
@@ -610,13 +611,15 @@ function requirePlatform(value, serviceName) {
   return value;
 }
 function loadTomlConfig(projectRoot, environment, globalConfigPath, reader, env) {
-  const projectConfigContent = reader.readIfExists(`${projectRoot}/.semiont/config`);
+  const projectConfigContent = projectRoot ? reader.readIfExists(`${projectRoot}/.semiont/config`) : null;
   let projectName = "semiont-project";
+  let projectVersion;
   let projectSite;
   let projectEnvSection = {};
   if (projectConfigContent) {
     const projectConfig = parse(projectConfigContent);
     projectName = projectConfig.project?.name ?? projectName;
+    projectVersion = projectConfig.project?.version;
     projectSite = projectConfig.site;
     projectEnvSection = projectConfig.environments?.[environment] ?? {};
   }
@@ -804,6 +807,7 @@ function loadTomlConfig(projectRoot, environment, globalConfigPath, reader, env)
       environment,
       projectRoot,
       projectName,
+      projectVersion,
       ...Object.keys(actors).length > 0 ? { actors } : {},
       ...Object.keys(workers).length > 0 ? { workers } : {}
     }