{ "openapi": "3.0.0", "info": { "title": "Semiont API", "version": "0.1.0", "description": "Semantic Knowledge Platform API", "license": { "name": "Apache-2.0", "url": "https://www.apache.org/licenses/LICENSE-2.0" } }, "servers": [ { "url": "http://{host}:{port}", "description": "A knowledge base's gateway, at the address its operator gives it.", "variables": { "host": { "default": "localhost" }, "port": { "default": "4000" } } } ], "paths": { "/api/health": { "$ref": "paths/api_health.json" }, "/": { "$ref": "paths/root.json" }, "/api/openapi.json": { "$ref": "paths/api_openapi.json" }, "/.well-known/oauth-protected-resource": { "$ref": "paths/well-known_oauth-protected-resource.json" }, "/api/tokens/media": { "$ref": "paths/api_tokens_media.json" }, "/api/users/me": { "$ref": "paths/api_users_me.json" }, "/api/status": { "$ref": "paths/api_status.json" }, "/bus/subscribe": { "$ref": "paths/bus_subscribe.json" }, "/bus/emit": { "$ref": "paths/bus_emit.json" }, "/resources": { "$ref": "paths/resources.json" }, "/resources/{id}": { "$ref": "paths/resources_{id}.json" }, "/resources/{id}/jsonld": { "$ref": "paths/resources_{id}_jsonld.json" }, "/resources/{id}/annotations": { "$ref": "paths/resources_{id}_annotations.json" }, "/resources/{id}/anchored-text": { "$ref": "paths/resources_{id}_anchored-text.json" }, "/api/resources/{id}": { "$ref": "paths/api_resources_{id}.json" } }, "components": { "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT", "x-semiont-limits": { "keySetMaxAgeSeconds": 600, "keyRefetchCooldownSeconds": 30, "keyFetchDeadlineSeconds": 5, "refusalsPerSecond": 10, "refusalBurst": 100, "refusalHolders": 1024 }, "description": "`Authorization: Bearer ` — the scheme name in any case (RFC 7235); a header naming another scheme, or none, carries no credential, and nor does a cookie.\n\n**The issuer's token.** People and agents alike sign in at the knowledge base's trusted issuer (`identity.issuer` in the gateway's configuration document), and the token it mints is their bearer here. Signed RS256 by a key the issuer publishes at the `jwks_uri` its `/.well-known/openid-configuration` names. The gateway fetches that key set when it holds none, when the one it holds is `x-semiont-limits.keySetMaxAgeSeconds` old, and for a `kid` the set does not have once the set is `keyRefetchCooldownSeconds` old. A fetch is given `keyFetchDeadlineSeconds`, discovery included; one that fails is not tried again for `keyRefetchCooldownSeconds`, and requests that need the keys meanwhile share the one fetch or its failure. With no usable set, a token is refused. `iss` must equal the configured issuer exactly. `aud` must contain this knowledge base's resource identifier: its did:web resolved to an https URL, the value `/.well-known/oauth-protected-resource` publishes as `resource`. Expired, not-yet-valid or wrongly signed tokens are refused. The holder is named by the subject its issuer asserted, the value of the claim `identity.subjectClaim` selects, which must be a non-empty string, percent-encoded, under the knowledge base's `site.domain`: `did:web::agents:` when the token's `kind` claim is `agent`, which the issuer stamps on every agent's account and no person's, and `did:web::users:` otherwise. `email` is optional; when present, `email_verified: false` is refused. `name` and `picture` are displayed when present. Capabilities ride a flat `roles` array: `semiont-service` marks a service's account, and `semiont-worker` grants the right to claim jobs. A token whose claims do not make a `UserId` names no principal and is refused. Whatever route it reaches, the verified holder's DID is what `POST /bus/emit` stamps as `_userId`, and the token's `roles` what it stamps as `_roles`. How every name here is formed — the encoding exactly, with cases — is specs/src/principals/cases.json.\n\n**Refused requests.** A request whose credential is refused is counted against the holder its token names, read without verifying it: the claim the gateway names a holder by, `identity.subjectClaim`, of a token naming the trusted issuer as its `iss`. A request with no token, or with one that names another issuer or no holder, is counted in one count shared by every such request. Each holder may have `x-semiont-limits.refusalBurst` requests refused at once, and `refusalsPerSecond` after, per gateway process; past that, a refused request is answered 429 with the `LimitRefusal` code `refusal-rate` and a `Retry-After` in place of its 401. A token that verifies is never counted and never limited, whatever its holder's count, so naming another's holder in a forged token cannot lock them out; and the roles a refused token claims are not read. The gateway counts at most `refusalHolders` holders, and drops the one it began counting first to count another." }, "mediaToken": { "type": "apiKey", "in": "query", "name": "token", "description": "A media token from `POST /api/tokens/media`: HS256 under the gateway's own key ring (`JWT_SECRET`), which signs nothing else, naming the knowledge base whose gateway minted it and one of its resources (`purpose: \"media\"`, `iss: `, `sub: `) and valid for five minutes. Accepted only by `GET /api/resources/{id}` of that knowledge base's gateway, and only for the resource it names: a gateway sharing the ring but serving another knowledge base refuses it — for ``, PDF.js and download links, which cannot send a header." } }, "responses": { "Unauthorized": { "$ref": "components/responses/Unauthorized.json" }, "InternalError": { "$ref": "components/responses/InternalError.json" }, "ServiceUnavailable": { "$ref": "components/responses/ServiceUnavailable.json" }, "PayloadTooLarge": { "$ref": "components/responses/PayloadTooLarge.json" }, "TooManyRequests": { "$ref": "components/responses/TooManyRequests.json" }, "AtCapacity": { "$ref": "components/responses/AtCapacity.json" } }, "schemas": { "Agent": { "$ref": "components/schemas/Agent.json" }, "AgentOrganization": { "$ref": "components/schemas/AgentOrganization.json" }, "AgentPerson": { "$ref": "components/schemas/AgentPerson.json" }, "AgentSoftware": { "$ref": "components/schemas/AgentSoftware.json" }, "Annotation": { "$ref": "components/schemas/Annotation.json" }, "AnnotationAddedPayload": { "$ref": "components/schemas/AnnotationAddedPayload.json" }, "AnnotationBodies": { "$ref": "components/schemas/AnnotationBodies.json" }, "AnnotationBody": { "$ref": "components/schemas/AnnotationBody.json" }, "AnnotationBodyUpdatedPayload": { "$ref": "components/schemas/AnnotationBodyUpdatedPayload.json" }, "AnnotationId": { "$ref": "components/schemas/AnnotationId.json" }, "AnnotationRemovedPayload": { "$ref": "components/schemas/AnnotationRemovedPayload.json" }, "AnnotationSelector": { "$ref": "components/schemas/AnnotationSelector.json" }, "AnnotationTarget": { "$ref": "components/schemas/AnnotationTarget.json" }, "AttributedEvent": { "$ref": "components/schemas/AttributedEvent.json" }, "BeckonFocusEvent": { "$ref": "components/schemas/BeckonFocusEvent.json" }, "BeckonHoverEvent": { "$ref": "components/schemas/BeckonHoverEvent.json" }, "BeckonSparkleEvent": { "$ref": "components/schemas/BeckonSparkleEvent.json" }, "BindBodyOperation": { "$ref": "components/schemas/BindBodyOperation.json" }, "BindBodyUpdated": { "$ref": "components/schemas/BindBodyUpdated.json" }, "BindInitiateCommand": { "$ref": "components/schemas/BindInitiateCommand.json" }, "BindUpdateBodyCommand": { "$ref": "components/schemas/BindUpdateBodyCommand.json" }, "BodyOperationAdd": { "$ref": "components/schemas/BodyOperationAdd.json" }, "BodyOperationRemove": { "$ref": "components/schemas/BodyOperationRemove.json" }, "BodyOperationReplace": { "$ref": "components/schemas/BodyOperationReplace.json" }, "BodyPurpose": { "$ref": "components/schemas/BodyPurpose.json" }, "BrowseEnginesRequest": { "$ref": "components/schemas/BrowseEnginesRequest.json" }, "BrowseEnginesResult": { "$ref": "components/schemas/BrowseEnginesResult.json" }, "BrowseProfilesRequest": { "$ref": "components/schemas/BrowseProfilesRequest.json" }, "BrowseProfilesResult": { "$ref": "components/schemas/BrowseProfilesResult.json" }, "BrowseAnnotationHistoryRequest": { "$ref": "components/schemas/BrowseAnnotationHistoryRequest.json" }, "BrowseAnnotationHistoryResult": { "$ref": "components/schemas/BrowseAnnotationHistoryResult.json" }, "BrowseAnnotationRequest": { "$ref": "components/schemas/BrowseAnnotationRequest.json" }, "BrowseAnnotationResult": { "$ref": "components/schemas/BrowseAnnotationResult.json" }, "BrowseClickEvent": { "$ref": "components/schemas/BrowseClickEvent.json" }, "BrowseDirectoryRequest": { "$ref": "components/schemas/BrowseDirectoryRequest.json" }, "BrowseDirectoryResult": { "$ref": "components/schemas/BrowseDirectoryResult.json" }, "BrowseDirectoryResultResponse": { "$ref": "components/schemas/BrowseDirectoryResultResponse.json" }, "BrowseEntityTypeClickedEvent": { "$ref": "components/schemas/BrowseEntityTypeClickedEvent.json" }, "BrowseEntityTypesRequest": { "$ref": "components/schemas/BrowseEntityTypesRequest.json" }, "BrowseEntityTypesResult": { "$ref": "components/schemas/BrowseEntityTypesResult.json" }, "BrowseEventsRequest": { "$ref": "components/schemas/BrowseEventsRequest.json" }, "BrowseEventsResult": { "$ref": "components/schemas/BrowseEventsResult.json" }, "BrowseExternalNavigateEvent": { "$ref": "components/schemas/BrowseExternalNavigateEvent.json" }, "BrowseFilesResponse": { "$ref": "components/schemas/BrowseFilesResponse.json" }, "BrowseKbRequest": { "$ref": "components/schemas/BrowseKbRequest.json" }, "BrowseKbResult": { "$ref": "components/schemas/BrowseKbResult.json" }, "BrowseLinkClickedEvent": { "$ref": "components/schemas/BrowseLinkClickedEvent.json" }, "BrowsePanelOpenEvent": { "$ref": "components/schemas/BrowsePanelOpenEvent.json" }, "BrowsePanelToggleEvent": { "$ref": "components/schemas/BrowsePanelToggleEvent.json" }, "BrowseResourceOpenEvent": { "$ref": "components/schemas/BrowseResourceOpenEvent.json" }, "BrowseResourceViewedEvent": { "$ref": "components/schemas/BrowseResourceViewedEvent.json" }, "BrowseResourceCloseEvent": { "$ref": "components/schemas/BrowseResourceCloseEvent.json" }, "BrowseResourceReorderEvent": { "$ref": "components/schemas/BrowseResourceReorderEvent.json" }, "AnchoredText": { "$ref": "components/schemas/AnchoredText.json" }, "JobId": { "$ref": "components/schemas/JobId.json" }, "PdfTextItem": { "$ref": "components/schemas/PdfTextItem.json" }, "AnchoredTextAnswer": { "$ref": "components/schemas/AnchoredTextAnswer.json" }, "AnchoredTextAbsent": { "$ref": "components/schemas/AnchoredTextAbsent.json" }, "BrowseResourceRequest": { "$ref": "components/schemas/BrowseResourceRequest.json" }, "BrowseResourceResult": { "$ref": "components/schemas/BrowseResourceResult.json" }, "BrowseResourcesRequest": { "$ref": "components/schemas/BrowseResourcesRequest.json" }, "BrowseResourcesResult": { "$ref": "components/schemas/BrowseResourcesResult.json" }, "BrowseRouterPushEvent": { "$ref": "components/schemas/BrowseRouterPushEvent.json" }, "BrowseTagSchemasRequest": { "$ref": "components/schemas/BrowseTagSchemasRequest.json" }, "BrowseTagSchemasResult": { "$ref": "components/schemas/BrowseTagSchemasResult.json" }, "BusEmitAccepted": { "$ref": "components/schemas/BusEmitAccepted.json" }, "BusEmitRequest": { "$ref": "components/schemas/BusEmitRequest.json" }, "BusSubscribeRequest": { "$ref": "components/schemas/BusSubscribeRequest.json" }, "CloneResourceWithTokenResponse": { "$ref": "components/schemas/CloneResourceWithTokenResponse.json" }, "EngineEntry": { "$ref": "components/schemas/EngineEntry.json" }, "CommandError": { "$ref": "components/schemas/CommandError.json" }, "ContentFormat": { "$ref": "components/schemas/ContentFormat.json" }, "ContextualSummaryResponse": { "$ref": "components/schemas/ContextualSummaryResponse.json" }, "CreateAnnotationRequest": { "$ref": "components/schemas/CreateAnnotationRequest.json" }, "CreateResourceResponse": { "$ref": "components/schemas/CreateResourceResponse.json" }, "DirEntry": { "$ref": "components/schemas/DirEntry.json" }, "DirectoryEntry": { "$ref": "components/schemas/DirectoryEntry.json" }, "DiscoveredKB": { "$ref": "discovery/DiscoveredKB.json" }, "DiscoveryDocument": { "$ref": "discovery/DiscoveryDocument.json" }, "EnrichedResourceEvent": { "$ref": "components/schemas/EnrichedResourceEvent.json" }, "EntityTagChangedPayload": { "$ref": "components/schemas/EntityTagChangedPayload.json" }, "EntityTypeAddedPayload": { "$ref": "components/schemas/EntityTypeAddedPayload.json" }, "ErrorResponse": { "$ref": "components/schemas/ErrorResponse.json" }, "EventMetadata": { "$ref": "components/schemas/EventMetadata.json" }, "ExtractedText": { "$ref": "components/schemas/ExtractedText.json" }, "ExtractionDeclined": { "$ref": "components/schemas/ExtractionDeclined.json" }, "ExtractionOutcome": { "$ref": "components/schemas/ExtractionOutcome.json" }, "FileEntry": { "$ref": "components/schemas/FileEntry.json" }, "FragmentSelector": { "$ref": "components/schemas/FragmentSelector.json" }, "FrameAddEntityTypeCommand": { "$ref": "components/schemas/FrameAddEntityTypeCommand.json" }, "FrameAddTagSchemaCommand": { "$ref": "components/schemas/FrameAddTagSchemaCommand.json" }, "GatherAnnotationComplete": { "$ref": "components/schemas/GatherAnnotationComplete.json" }, "GatherAnnotationOptions": { "$ref": "components/schemas/GatherAnnotationOptions.json" }, "GatherAnnotationRequest": { "$ref": "components/schemas/GatherAnnotationRequest.json" }, "GatherResourceComplete": { "$ref": "components/schemas/GatherResourceComplete.json" }, "GatherResourceRequest": { "$ref": "components/schemas/GatherResourceRequest.json" }, "GatherResourceRequestOptions": { "$ref": "components/schemas/GatherResourceRequestOptions.json" }, "GatherSummaryRequest": { "$ref": "components/schemas/GatherSummaryRequest.json" }, "GatherReferencedByRequest": { "$ref": "components/schemas/GatherReferencedByRequest.json" }, "GatherReferencedByResult": { "$ref": "components/schemas/GatherReferencedByResult.json" }, "DurabilityEvidence": { "$ref": "components/schemas/DurabilityEvidence.json" }, "FailureClass": { "$ref": "components/schemas/FailureClass.json" }, "GatheredContext": { "$ref": "components/schemas/GatheredContext.json" }, "GenerationJobParams": { "$ref": "components/schemas/GenerationJobParams.json" }, "GetAnnotationHistoryResponse": { "$ref": "components/schemas/GetAnnotationHistoryResponse.json" }, "GetAnnotationResponse": { "$ref": "components/schemas/GetAnnotationResponse.json" }, "GetAnnotationsResponse": { "$ref": "components/schemas/GetAnnotationsResponse.json" }, "GetEntityTypesResponse": { "$ref": "components/schemas/GetEntityTypesResponse.json" }, "GetEventsResponse": { "$ref": "components/schemas/GetEventsResponse.json" }, "GetReferencedByResponse": { "$ref": "components/schemas/GetReferencedByResponse.json" }, "GetReferencedByResponseReferencedByItem": { "$ref": "components/schemas/GetReferencedByResponseReferencedByItem.json" }, "GetResourceByTokenResponse": { "$ref": "components/schemas/GetResourceByTokenResponse.json" }, "GetResourceResponse": { "$ref": "components/schemas/GetResourceResponse.json" }, "GetTagSchemasResponse": { "$ref": "components/schemas/GetTagSchemasResponse.json" }, "HealthResponse": { "$ref": "components/schemas/HealthResponse.json" }, "InferenceLimits": { "$ref": "components/schemas/InferenceLimits.json" }, "InferenceLimitsRequest": { "$ref": "components/schemas/InferenceLimitsRequest.json" }, "InferenceLimitsResult": { "$ref": "components/schemas/InferenceLimitsResult.json" }, "EngineLimits": { "$ref": "components/schemas/EngineLimits.json" }, "GraphAnnotationNode": { "$ref": "components/schemas/GraphAnnotationNode.json" }, "GraphResourceNode": { "$ref": "components/schemas/GraphResourceNode.json" }, "JobCancelRequest": { "$ref": "components/schemas/JobCancelRequest.json" }, "JobCancelCommand": { "$ref": "components/schemas/JobCancelCommand.json" }, "JobClaimCommand": { "$ref": "components/schemas/JobClaimCommand.json" }, "JobCompleteCommand": { "$ref": "components/schemas/JobCompleteCommand.json" }, "JobCompletedPayload": { "$ref": "components/schemas/JobCompletedPayload.json" }, "JobCreateCommand": { "$ref": "components/schemas/JobCreateCommand.json" }, "JobCreatedResult": { "$ref": "components/schemas/JobCreatedResult.json" }, "JobCreatedResultResponse": { "$ref": "components/schemas/JobCreatedResultResponse.json" }, "JobFailCommand": { "$ref": "components/schemas/JobFailCommand.json" }, "JobCheckpointCommand": { "$ref": "components/schemas/JobCheckpointCommand.json" }, "ResourceId": { "$ref": "components/schemas/ResourceId.json" }, "UnitCursor": { "$ref": "./components/schemas/UnitCursor.json" }, "JobDeclined": { "$ref": "components/schemas/JobDeclined.json" }, "JobFailedPayload": { "$ref": "components/schemas/JobFailedPayload.json" }, "YieldJobDone": { "$ref": "components/schemas/YieldJobDone.json" }, "JobProgress": { "$ref": "components/schemas/JobProgress.json" }, "JobProgressMessage": { "$ref": "components/schemas/JobProgressMessage.json" }, "JobProgressAnalyzing": { "$ref": "components/schemas/JobProgressAnalyzing.json" }, "JobProgressAnalyzingTags": { "$ref": "components/schemas/JobProgressAnalyzingTags.json" }, "JobProgressCompleteCreated": { "$ref": "components/schemas/JobProgressCompleteCreated.json" }, "JobProgressCompleteGenerated": { "$ref": "components/schemas/JobProgressCompleteGenerated.json" }, "JobProgressCreatingAnnotations": { "$ref": "components/schemas/JobProgressCreatingAnnotations.json" }, "JobProgressCreatingResource": { "$ref": "components/schemas/JobProgressCreatingResource.json" }, "JobProgressCreatingTagAnnotations": { "$ref": "components/schemas/JobProgressCreatingTagAnnotations.json" }, "JobProgressDetectingEntities": { "$ref": "components/schemas/JobProgressDetectingEntities.json" }, "JobProgressGeneratingResource": { "$ref": "components/schemas/JobProgressGeneratingResource.json" }, "JobProgressLoading": { "$ref": "components/schemas/JobProgressLoading.json" }, "JobQueuedEvent": { "$ref": "components/schemas/JobQueuedEvent.json" }, "MarkJobDone": { "$ref": "components/schemas/MarkJobDone.json" }, "JobReportProgressCommand": { "$ref": "components/schemas/JobReportProgressCommand.json" }, "JobResult": { "$ref": "components/schemas/JobResult.json" }, "JobStartCommand": { "$ref": "components/schemas/JobStartCommand.json" }, "JobAssignCommand": { "$ref": "components/schemas/JobAssignCommand.json" }, "JobStartedPayload": { "$ref": "components/schemas/JobStartedPayload.json" }, "JobAssignedPayload": { "$ref": "components/schemas/JobAssignedPayload.json" }, "PrincipalProfileCommand": { "$ref": "components/schemas/PrincipalProfileCommand.json" }, "PrincipalProfiledPayload": { "$ref": "components/schemas/PrincipalProfiledPayload.json" }, "JobStatusRequest": { "$ref": "components/schemas/JobStatusRequest.json" }, "JobStatusResponse": { "$ref": "components/schemas/JobStatusResponse.json" }, "JobStatusResult": { "$ref": "components/schemas/JobStatusResult.json" }, "JobType": { "$ref": "components/schemas/JobType.json" }, "KbDescription": { "$ref": "components/schemas/KbDescription.json" }, "HttpEndpoint": { "$ref": "components/schemas/HttpEndpoint.json" }, "KbEndpoint": { "$ref": "components/schemas/KbEndpoint.json" }, "KbRead": { "$ref": "components/schemas/KbRead.json" }, "KbTarget": { "$ref": "components/schemas/KbTarget.json" }, "KnowledgeBase": { "$ref": "components/schemas/KnowledgeBase.json" }, "LocalEndpoint": { "$ref": "components/schemas/LocalEndpoint.json" }, "NewKnowledgeBase": { "$ref": "components/schemas/NewKnowledgeBase.json" }, "KnowledgeGraph": { "$ref": "components/schemas/KnowledgeGraph.json" }, "ListResourcesResponse": { "$ref": "components/schemas/ListResourcesResponse.json" }, "MarkArchiveCommand": { "$ref": "components/schemas/MarkArchiveCommand.json" }, "MarkCreateOk": { "$ref": "components/schemas/MarkCreateOk.json" }, "MarkCreateOkResponse": { "$ref": "components/schemas/MarkCreateOkResponse.json" }, "MarkCommitCommand": { "$ref": "components/schemas/MarkCommitCommand.json" }, "MarkCommitOk": { "$ref": "components/schemas/MarkCommitOk.json" }, "MarkCreateRequest": { "$ref": "components/schemas/MarkCreateRequest.json" }, "MarkDeleteCommand": { "$ref": "components/schemas/MarkDeleteCommand.json" }, "MarkDeleteOk": { "$ref": "components/schemas/MarkDeleteOk.json" }, "MarkRequestedEvent": { "$ref": "components/schemas/MarkRequestedEvent.json" }, "MarkSubmitEvent": { "$ref": "components/schemas/MarkSubmitEvent.json" }, "MarkUnarchiveCommand": { "$ref": "components/schemas/MarkUnarchiveCommand.json" }, "MarkUpdateBodyCommand": { "$ref": "components/schemas/MarkUpdateBodyCommand.json" }, "MarkUpdateEntityTypesCommand": { "$ref": "components/schemas/MarkUpdateEntityTypesCommand.json" }, "MatchSearchFailed": { "$ref": "components/schemas/MatchSearchFailed.json" }, "MatchSearchRequest": { "$ref": "components/schemas/MatchSearchRequest.json" }, "MatchSearchResult": { "$ref": "components/schemas/MatchSearchResult.json" }, "MatchResourcesRequest": { "$ref": "components/schemas/MatchResourcesRequest.json" }, "MatchResourcesResponse": { "$ref": "components/schemas/MatchResourcesResponse.json" }, "MatchResourcesResult": { "$ref": "components/schemas/MatchResourcesResult.json" }, "MediaTokenRequest": { "$ref": "components/schemas/MediaTokenRequest.json" }, "MediaTokenResponse": { "$ref": "components/schemas/MediaTokenResponse.json" }, "Motivation": { "$ref": "components/schemas/Motivation.json" }, "ProtectedResourceMetadata": { "$ref": "components/schemas/ProtectedResourceMetadata.json" }, "Representation": { "$ref": "components/schemas/Representation.json" }, "RepresentationAddedPayload": { "$ref": "components/schemas/RepresentationAddedPayload.json" }, "RepresentationRemovedPayload": { "$ref": "components/schemas/RepresentationRemovedPayload.json" }, "ResourceArchivedPayload": { "$ref": "components/schemas/ResourceArchivedPayload.json" }, "ResourceClonedPayload": { "$ref": "components/schemas/ResourceClonedPayload.json" }, "ResourceCreatedPayload": { "$ref": "components/schemas/ResourceCreatedPayload.json" }, "ResourceDescriptor": { "$ref": "components/schemas/ResourceDescriptor.json" }, "ResourceMovedPayload": { "$ref": "components/schemas/ResourceMovedPayload.json" }, "ResourceUnarchivedPayload": { "$ref": "components/schemas/ResourceUnarchivedPayload.json" }, "ResourceUpdatedPayload": { "$ref": "components/schemas/ResourceUpdatedPayload.json" }, "ScoredResource": { "$ref": "components/schemas/ScoredResource.json" }, "SemanticMatch": { "$ref": "components/schemas/SemanticMatch.json" }, "SessionJoinedEvent": { "$ref": "components/schemas/SessionJoinedEvent.json" }, "SessionLeftEvent": { "$ref": "components/schemas/SessionLeftEvent.json" }, "SettingsHoverDelayChangedEvent": { "$ref": "components/schemas/SettingsHoverDelayChangedEvent.json" }, "SettingsLocaleChangedEvent": { "$ref": "components/schemas/SettingsLocaleChangedEvent.json" }, "SettingsThemeChangedEvent": { "$ref": "components/schemas/SettingsThemeChangedEvent.json" }, "SpecificResource": { "$ref": "components/schemas/SpecificResource.json" }, "StatusResponse": { "$ref": "components/schemas/StatusResponse.json" }, "StoredEventResponse": { "$ref": "components/schemas/StoredEventResponse.json" }, "SupportedMediaType": { "$ref": "components/schemas/SupportedMediaType.json" }, "Selector": { "$ref": "components/schemas/Selector.json" }, "SvgSelector": { "$ref": "components/schemas/SvgSelector.json" }, "TagCategory": { "$ref": "components/schemas/TagCategory.json" }, "TagSchema": { "$ref": "components/schemas/TagSchema.json" }, "TagSchemaAddedPayload": { "$ref": "components/schemas/TagSchemaAddedPayload.json" }, "TextPositionSelector": { "$ref": "components/schemas/TextPositionSelector.json" }, "TextQuoteSelector": { "$ref": "components/schemas/TextQuoteSelector.json" }, "TextualBody": { "$ref": "components/schemas/TextualBody.json" }, "UpdateAnnotationBodyRequest": { "$ref": "components/schemas/UpdateAnnotationBodyRequest.json" }, "UserId": { "$ref": "components/schemas/UserId.json" }, "UserResponse": { "$ref": "components/schemas/UserResponse.json" }, "SmeltRebuildAnchorsCommand": { "$ref": "components/schemas/SmeltRebuildAnchorsCommand.json" }, "WeaveRebuildCommand": { "$ref": "components/schemas/WeaveRebuildCommand.json" }, "YieldCloneCreateCommand": { "$ref": "components/schemas/YieldCloneCreateCommand.json" }, "YieldCloneCreated": { "$ref": "components/schemas/YieldCloneCreated.json" }, "YieldCloneResourceRequest": { "$ref": "components/schemas/YieldCloneResourceRequest.json" }, "YieldCloneTokenRequest": { "$ref": "components/schemas/YieldCloneTokenRequest.json" }, "YieldCreateCommand": { "$ref": "components/schemas/YieldCreateCommand.json" }, "YieldClonePersistCommand": { "$ref": "components/schemas/YieldClonePersistCommand.json" }, "YieldCreateOk": { "$ref": "components/schemas/YieldCreateOk.json" }, "YieldClonePersistOk": { "$ref": "components/schemas/YieldClonePersistOk.json" }, "YieldUpdateCommand": { "$ref": "components/schemas/YieldUpdateCommand.json" }, "YieldUpdateOk": { "$ref": "components/schemas/YieldUpdateOk.json" }, "BusEventMessage": { "$ref": "components/schemas/BusEventMessage.json" }, "BusFrame": { "$ref": "components/schemas/BusFrame.json" }, "BusPingMessage": { "$ref": "components/schemas/BusPingMessage.json" }, "BusResumeGap": { "$ref": "components/schemas/BusResumeGap.json" }, "BusStreamMessage": { "$ref": "components/schemas/BusStreamMessage.json" }, "EphemeralEventId": { "$ref": "components/schemas/EphemeralEventId.json" }, "PersistedEventId": { "$ref": "components/schemas/PersistedEventId.json" }, "ReplyEventId": { "$ref": "components/schemas/ReplyEventId.json" }, "GatewayConfig": { "$ref": "components/schemas/GatewayConfig.json" }, "KbIdentity": { "$ref": "components/schemas/KbIdentity.json" }, "ResourceUpload": { "$ref": "components/schemas/ResourceUpload.json" }, "ArchivistEventsResponse": { "$ref": "components/schemas/ArchivistEventsResponse.json" }, "ArchivistStream": { "$ref": "components/schemas/ArchivistStream.json" }, "ArchivistStreamsResponse": { "$ref": "components/schemas/ArchivistStreamsResponse.json" }, "ArchivistHealth": { "$ref": "components/schemas/ArchivistHealth.json" }, "RepresentationNotFound": { "$ref": "components/schemas/RepresentationNotFound.json" }, "LimitRefusal": { "$ref": "components/schemas/LimitRefusal.json" }, "JobMetadata": { "$ref": "components/schemas/JobMetadata.json" }, "JobParams": { "$ref": "components/schemas/JobParams.json" }, "MarkJobParams": { "$ref": "components/schemas/MarkJobParams.json" }, "HighlightingJobParams": { "$ref": "components/schemas/HighlightingJobParams.json" }, "CommentingJobParams": { "$ref": "components/schemas/CommentingJobParams.json" }, "AssessingJobParams": { "$ref": "components/schemas/AssessingJobParams.json" }, "LinkingJobParams": { "$ref": "components/schemas/LinkingJobParams.json" }, "TaggingJobParams": { "$ref": "components/schemas/TaggingJobParams.json" }, "GenerationJobRequest": { "$ref": "components/schemas/GenerationJobRequest.json" }, "MarkJobCreateCommand": { "$ref": "components/schemas/MarkJobCreateCommand.json" }, "YieldJobCreateCommand": { "$ref": "components/schemas/YieldJobCreateCommand.json" }, "MarkJobQueuedEvent": { "$ref": "components/schemas/MarkJobQueuedEvent.json" }, "YieldJobQueuedEvent": { "$ref": "components/schemas/YieldJobQueuedEvent.json" }, "MarkJobResult": { "$ref": "components/schemas/MarkJobResult.json" }, "YieldJobResult": { "$ref": "components/schemas/YieldJobResult.json" }, "MarkJobCompleteCommand": { "$ref": "components/schemas/MarkJobCompleteCommand.json" }, "YieldJobCompleteCommand": { "$ref": "components/schemas/YieldJobCompleteCommand.json" }, "JobFilter": { "$ref": "components/schemas/JobFilter.json" }, "MarkJobFilter": { "$ref": "components/schemas/MarkJobFilter.json" }, "YieldJobFilter": { "$ref": "components/schemas/YieldJobFilter.json" }, "JobPending": { "$ref": "components/schemas/JobPending.json" }, "JobStoredProgress": { "$ref": "components/schemas/JobStoredProgress.json" }, "JobStoredResult": { "$ref": "components/schemas/JobStoredResult.json" }, "JobRunning": { "$ref": "components/schemas/JobRunning.json" }, "JobComplete": { "$ref": "components/schemas/JobComplete.json" }, "JobFailed": { "$ref": "components/schemas/JobFailed.json" }, "JobCancelled": { "$ref": "components/schemas/JobCancelled.json" }, "Job": { "$ref": "components/schemas/Job.json" }, "JobRecord": { "$ref": "components/schemas/JobRecord.json" }, "JobClaimedResult": { "$ref": "components/schemas/JobClaimedResult.json" }, "LogLevel": { "$ref": "components/schemas/LogLevel.json" }, "LogFormat": { "$ref": "components/schemas/LogFormat.json" }, "DispatcherConfig": { "$ref": "components/schemas/DispatcherConfig.json" }, "WorkerConfig": { "$ref": "components/schemas/WorkerConfig.json" }, "WorkerEngineConfig": { "$ref": "components/schemas/WorkerEngineConfig.json" }, "WorkerKnowledgeBaseConfig": { "$ref": "components/schemas/WorkerKnowledgeBaseConfig.json" }, "WorkerHealth": { "$ref": "components/schemas/WorkerHealth.json" }, "WorkerKnowledgeBaseHealth": { "$ref": "components/schemas/WorkerKnowledgeBaseHealth.json" }, "WorkerEngineHealth": { "$ref": "components/schemas/WorkerEngineHealth.json" }, "CursorsPath": { "$ref": "components/schemas/CursorsPath.json" }, "WeaverConfig": { "$ref": "components/schemas/WeaverConfig.json" }, "GraphConfig": { "$ref": "components/schemas/GraphConfig.json" }, "Neo4jGraphConfig": { "$ref": "components/schemas/Neo4jGraphConfig.json" }, "JanusGraphConfig": { "$ref": "components/schemas/JanusGraphConfig.json" }, "NeptuneGraphConfig": { "$ref": "components/schemas/NeptuneGraphConfig.json" }, "MemoryGraphConfig": { "$ref": "components/schemas/MemoryGraphConfig.json" }, "SmelterConfig": { "$ref": "components/schemas/SmelterConfig.json" }, "LibrarianConfig": { "$ref": "components/schemas/LibrarianConfig.json" }, "LibrarianEngineConfig": { "$ref": "components/schemas/LibrarianEngineConfig.json" }, "EmbeddingConfig": { "$ref": "components/schemas/EmbeddingConfig.json" }, "OllamaEmbeddingConfig": { "$ref": "components/schemas/OllamaEmbeddingConfig.json" }, "VoyageEmbeddingConfig": { "$ref": "components/schemas/VoyageEmbeddingConfig.json" }, "VectorsConfig": { "$ref": "components/schemas/VectorsConfig.json" }, "QdrantVectorsConfig": { "$ref": "components/schemas/QdrantVectorsConfig.json" }, "MemoryVectorsConfig": { "$ref": "components/schemas/MemoryVectorsConfig.json" }, "DispatcherHealth": { "$ref": "components/schemas/DispatcherHealth.json" }, "ArchivistConfig": { "$ref": "components/schemas/ArchivistConfig.json" }, "ResourceAnnotations": { "$ref": "components/schemas/ResourceAnnotations.json" }, "ResourceView": { "$ref": "components/schemas/ResourceView.json" }, "EntityTypesProjection": { "$ref": "components/schemas/EntityTypesProjection.json" }, "TagSchemasProjection": { "$ref": "components/schemas/TagSchemasProjection.json" }, "ProfilesProjection": { "$ref": "components/schemas/ProfilesProjection.json" }, "Profile": { "$ref": "components/schemas/Profile.json" }, "StorageUriEntry": { "$ref": "components/schemas/StorageUriEntry.json" }, "AnchoredTextEntry": { "$ref": "components/schemas/AnchoredTextEntry.json" }, "AnchoredTextExtractedEntry": { "$ref": "components/schemas/AnchoredTextExtractedEntry.json" }, "AnchoredTextDeclinedEntry": { "$ref": "components/schemas/AnchoredTextDeclinedEntry.json" }, "AnchoredTextEntries": { "$ref": "components/schemas/AnchoredTextEntries.json" }, "AnchoredTextStamp": { "$ref": "components/schemas/AnchoredTextStamp.json" }, "AnchoredTextWrite": { "$ref": "components/schemas/AnchoredTextWrite.json" }, "ArchivistEngines": { "$ref": "components/schemas/ArchivistEngines.json" }, "Engine": { "$ref": "components/schemas/Engine.json" }, "GatherFailed": { "$ref": "components/schemas/GatherFailed.json" }, "GatherResourceFailed": { "$ref": "components/schemas/GatherResourceFailed.json" }, "BrowseDirectoryFailed": { "$ref": "components/schemas/BrowseDirectoryFailed.json" }, "MarkDelegateTimeoutEvent": { "$ref": "components/schemas/MarkDelegateTimeoutEvent.json" }, "ResourceErrorEvent": { "$ref": "components/schemas/ResourceErrorEvent.json" }, "JobCancelResult": { "$ref": "components/schemas/JobCancelResult.json" }, "WeaveApplied": { "$ref": "components/schemas/WeaveApplied.json" }, "SmeltSettled": { "$ref": "components/schemas/SmeltSettled.json" } } } }