@semiont/core 0.5.3 → 0.5.5

package/dist/index.d.ts

@@ -1,6 +1,4 @@
 import { Subject, OperatorFunction, Observable } from 'rxjs';
-import { E as EnvironmentConfig, P as PlatformType$1 } from './config.types-oPv3Ajk-.js';
-export { A as AnthropicProviderConfig, a as AppConfig, B as BackendServiceConfig, D as DatabaseServiceConfig, b as EmbeddingServiceConfig, F as FrontendServiceConfig, G as GraphDatabaseType, c as GraphServiceConfig, I as InferenceProvidersConfig, M as McpServiceConfig, O as OllamaProviderConfig, S as SemiontConfig, d as ServicePlatformConfig, e as ServicesConfig, f as SiteConfig, V as VectorsServiceConfig } from './config.types-oPv3Ajk-.js';
 
 /**
  * This file was auto-generated by openapi-typescript.
@@ -320,7 +318,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/api/tokens/worker": {
+    "/api/tokens/agent": {
         parameters: {
             query?: never;
             header?: never;
@@ -330,8 +328,10 @@ interface paths {
         get?: never;
         put?: never;
         /**
-         * Worker Token Exchange
-         * @description Exchange a shared secret for a bearer JWT. Used by workers and actors connecting to the EventBus.
+         * Software-Agent Token Exchange
+         * @description Exchange the shared secret plus an inference (provider, model) pair for a bearer JWT issued for that agent identity. Used by worker processes that emit on behalf of one or more software peers.
+         *
+         *     The issued JWT carries the agent's DID (shape `did:web:<host>:agents:<provider>:<model>`); the bus stamps that DID onto `_userId` so events the agent emits attribute to the agent rather than to a generic worker pool.
          */
         post: {
             parameters: {
@@ -343,8 +343,12 @@ interface paths {
             requestBody: {
                 content: {
                     "application/json": {
-                        /** @description The shared worker secret (SEMIONT_WORKER_SECRET) */
+                        /** @description The shared secret (SEMIONT_WORKER_SECRET) */
                         secret: string;
+                        /** @description Inference provider (e.g. ollama, anthropic) */
+                        provider: string;
+                        /** @description Model identifier (e.g. gemma2:27b, claude-3-5-sonnet) */
+                        model: string;
                     };
                 };
             };
@@ -358,10 +362,21 @@ interface paths {
                         "application/json": {
                             /** @description Bearer JWT for subsequent authenticated requests */
                             token: string;
+                            /** @description DID of the software-agent identity the token is acting as */
+                            did: string;
                         };
                     };
                 };
-                /** @description Invalid worker secret */
+                /** @description Missing or invalid request fields */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Invalid agent secret */
                 401: {
                     headers: {
                         [name: string]: unknown;
@@ -370,7 +385,7 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Worker authentication not configured */
+                /** @description Agent authentication not configured */
                 503: {
                     headers: {
                         [name: string]: unknown;
@@ -1536,8 +1551,6 @@ interface paths {
                         language?: string;
                         /** @description JSON-stringified array of entity type names */
                         entityTypes?: string;
-                        /** @description How this resource was created (api, ui, upload, reference, cli, clone, generated) */
-                        creationMethod?: string;
                         /** @description For AI-generated resources: the annotation that triggered generation. Nested into generatedFrom.annotationId on the persisted event. */
                         sourceAnnotationId?: string;
                         /** @description For AI-generated resources: the source resource the generating annotation lives on. Nested into generatedFrom.resourceId on the persisted event. */
@@ -1790,15 +1803,16 @@ interface components {
                 }[];
             };
         };
-        /** @description Minimal Person/Organization for attribution (W3C PROV compatible) */
-        Agent: {
+        /** @description Web Annotation / W3C PROV Agent. Discriminated by @type — Person, Organization, or Software. Each branch carries fields appropriate to its kind. Software peers are first-class participants, not a sub-class of Person. */
+        Agent: ({
+            /** @constant */
+            "@type": "Person";
             /**
              * Format: uri
-             * @description Unique identifier for the agent
+             * @description DID-shaped identifier (e.g. did:web:host:users:email%40host)
              */
             "@id"?: string;
-            /** @description Type(s) of agent (Person, Organization, Software) */
-            "@type"?: string | string[];
+            /** @description Display name */
             name: string;
             nickname?: string;
             email?: string;
@@ -1806,7 +1820,36 @@ interface components {
             homepage?: string;
         } & {
             [key: string]: unknown;
-        };
+        }) | ({
+            /** @constant */
+            "@type": "Organization";
+            /** Format: uri */
+            "@id"?: string;
+            name: string;
+            homepage?: string;
+        } & {
+            [key: string]: unknown;
+        }) | ({
+            /** @constant */
+            "@type": "Software";
+            /**
+             * Format: uri
+             * @description DID-shaped identifier (e.g. did:web:host:agents:provider:model)
+             */
+            "@id"?: string;
+            /** @description Stable human-friendly label. Not parsed; UI composes display from structured fields. */
+            name: string;
+            /** @description Inference provider (e.g. ollama, anthropic) */
+            provider?: string;
+            /** @description Model identifier (e.g. gemma2:27b, claude-3-5-sonnet) */
+            model?: string;
+            /** @description Inference parameters (temperature, maxTokens, systemPrompt, etc.). Runtime metadata, not part of identity. */
+            parameters?: {
+                [key: string]: unknown;
+            };
+        } & {
+            [key: string]: unknown;
+        });
         Annotation: {
             /**
              * @description W3C Web Annotation JSON-LD context
@@ -1826,10 +1869,14 @@ interface components {
             target: string | components["schemas"]["AnnotationTarget"];
             /** @description W3C Web Annotation body. Optional per the W3C spec — annotations whose motivation alone is meaningful (highlighting) legitimately omit it. Present values are either a single body or a non-empty array of bodies; the prior empty-array 'stub' branch has been removed (it was a naming lie shared between highlights and never-actually-emitted stub references, and the source of the #651 reference-annotation validator bug). */
             body?: components["schemas"]["AnnotationBody"] | components["schemas"]["AnnotationBody"][];
+            /** @description Web Annotation creator — the entity that initiated the annotation. For human-driven work this is a Person; for autonomous-agent work this is a Software peer. */
             creator?: components["schemas"]["Agent"];
             created?: string;
             modified?: string;
-            generator?: components["schemas"]["Agent"];
+            /** @description Web Annotation generator — the SoftwareAgent that produced the annotation, when software was involved. Absent for purely manual annotations. Single object is the common case; array supports pipelines that combine multiple software peers. */
+            generator?: components["schemas"]["Agent"] | components["schemas"]["Agent"][];
+            /** @description PROV-O wasAttributedTo — all parties responsible for this annotation. For human-prompted AI work this combines `creator` (the Person) and `generator` (the Software). For purely manual annotations it equals `[creator]`; for autonomous-agent work it equals `[generator]` (and `creator` may be the same Software). */
+            wasAttributedTo?: components["schemas"]["Agent"] | components["schemas"]["Agent"][];
         };
         /** @description Phase 2: Body can be TextualBody (for entity tags, descriptions) or SpecificResource (for links) */
         AnnotationBody: components["schemas"]["TextualBody"] | components["schemas"]["SpecificResource"];
@@ -2154,8 +2201,6 @@ interface components {
             /** @description SHA-256 of content */
             contentChecksum: string;
             contentByteSize?: number;
-            /** @enum {string} */
-            creationMethod: "api" | "upload" | "ui" | "reference" | "cli" | "clone" | "generated";
             entityTypes?: string[];
             /** @description Working-tree URI (e.g. file://docs/overview.md) */
             storageUri?: string;
@@ -2175,8 +2220,6 @@ interface components {
             contentChecksum: string;
             contentByteSize?: number;
             parentResourceId: string;
-            /** @enum {string} */
-            creationMethod: "api" | "upload" | "ui" | "reference" | "cli" | "clone" | "generated";
             entityTypes?: string[];
             language?: string;
         };
@@ -2514,11 +2557,6 @@ interface components {
             entityTypes?: string[];
             /** @description Application-specific: Whether this resource is a draft */
             isDraft?: boolean;
-            /**
-             * @description Application-specific: How this resource was created
-             * @enum {string}
-             */
-            creationMethod?: "api" | "upload" | "ui" | "reference" | "cli" | "clone" | "generated";
             /** @description Application-specific: ID of annotation that triggered generation */
             sourceAnnotationId?: string;
             /** @description Application-specific: ID of source resource for clones/derivatives */
@@ -3428,7 +3466,6 @@ interface components {
             format: components["schemas"]["ContentFormat"];
             language?: string;
             entityTypes?: string[];
-            creationMethod?: string;
             isDraft?: boolean;
             generatedFrom?: {
                 resourceId?: string;
@@ -3548,26 +3585,6 @@ declare function resourceUri(uri: string): ResourceUri;
 declare function annotationUri(uri: string): AnnotationUri;
 declare function resourceAnnotationUri(uri: string): ResourceAnnotationUri;
 
-/**
- * Resource creation methods - How resources are created in the system
- */
-/**
- * Enumeration of all possible resource creation methods
- */
-declare const CREATION_METHODS: {
-    readonly API: "api";
-    readonly UPLOAD: "upload";
-    readonly UI: "ui";
-    readonly REFERENCE: "reference";
-    readonly CLI: "cli";
-    readonly CLONE: "clone";
-    readonly GENERATED: "generated";
-};
-/**
- * Type for resource creation methods
- */
-type CreationMethod = typeof CREATION_METHODS[keyof typeof CREATION_METHODS];
-
 /**
  * Branded identifier types for compile-time type safety.
  *
@@ -5294,7 +5311,6 @@ interface PutBinaryRequest {
     storageUri: string;
     entityTypes?: string[];
     language?: string;
-    creationMethod?: CreationMethod | string;
     sourceAnnotationId?: AnnotationId | string;
     sourceResourceId?: ResourceId | string;
     generationPrompt?: string;
@@ -5843,35 +5859,48 @@ declare function isDefined<T>(value: T | null | undefined): value is T;
 /**
  * DID (Decentralized Identifier) and W3C Agent utilities
  *
- * Provides utilities for working with DID:WEB identifiers and converting
- * between user representations and W3C Web Annotation Agent objects.
+ * DID:WEB shapes used in Semiont:
+ *
+ *   Person:   did:web:<host>:users:<email%40host>
+ *   Software: did:web:<host>:agents:<provider>:<model>
+ *
+ * `didToAgent` is the inverse: parse the DID, recognize whether the
+ * subject is a person or a software peer, and return a typed Agent.
+ *
+ * Humans and software peers share the same identity *shape* (a DID
+ * with a typed Agent on read). What differs is the path segment
+ * (`:users:` vs `:agents:`) and the schema-typed fields each kind
+ * carries on its Agent record.
  */
 
 type Agent = components['schemas']['Agent'];
 /**
- * Convert a user object to a DID:WEB identifier
+ * Convert a user object to a DID:WEB identifier.
  *
- * Format: did:web:domain.com:users:email%40domain.com
- * Example: did:web:example.com:users:alice%40example.com
- *
- * Email is used as the stable, human-readable identifier (URI-encoded).
- * This is used for W3C Web Annotation compliance and federation readiness.
- *
- * @param user - User object with email and domain
- * @returns DID:WEB identifier string
+ * Format: did:web:<domain>:users:<email%40domain>
  */
 declare function userToDid(user: {
     email: string;
     domain: string;
 }): string;
 /**
- * Convert a user object to a W3C Agent object with DID:WEB identifier
+ * Convert a software peer's (provider, model) configuration to a DID:WEB
+ * identifier. Pool-vs-individual deployment is not part of identity —
+ * one DID per (provider, model) on this host.
  *
- * Creates a full Agent object for W3C Web Annotation compliance.
- * Includes DID:WEB identifier, type, and name.
+ * Format: did:web:<domain>:agents:<provider>:<model%2F-encoded>
  *
- * @param user - User object with id, domain, name, and email
- * @returns W3C Agent object
+ * Model strings often contain `:` and `/` (e.g. `gemma2:27b`,
+ * `library/llama3`); both must be URI-encoded so DID parsing isn't
+ * ambiguous.
+ */
+declare function agentToDid(agent: {
+    domain: string;
+    provider: string;
+    model: string;
+}): string;
+/**
+ * Convert a user object to a typed Person Agent with a DID:WEB identifier.
  */
 declare function userToAgent(user: {
     id: string;
@@ -5880,17 +5909,588 @@ declare function userToAgent(user: {
     email: string;
 }): Agent;
 /**
- * Convert a DID string to a minimal W3C Agent object
+ * Convert a software peer's configuration to a typed Software Agent.
+ * The `name` is a stable human-friendly label, not a parseable join —
+ * UI composes display from `provider`/`model` at render time.
+ */
+declare function softwareToAgent(software: {
+    domain: string;
+    provider: string;
+    model: string;
+    parameters?: Record<string, unknown>;
+}): Agent;
+/**
+ * Parse a DID:WEB string into a typed Agent.
  *
- * Used when reconstructing annotations from events where only the DID is available.
- * Creates a minimal Agent with just the required fields (id, type).
- * Name is derived from the DID for display purposes.
+ * Recognizes:
+ *   did:web:<host>:users:<email>           → Person  (name = decoded email)
+ *   did:web:<host>:agents:<provider>:<model> → Software (provider + model)
  *
- * @param did - DID:WEB identifier string
- * @returns Minimal W3C Agent object
+ * Anything else falls back to a Person with the trailing segment as
+ * `name`. This is the read-side inverse of `userToDid`/`agentToDid`.
  */
 declare function didToAgent(did: string | undefined | null): Agent;
 
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "PlatformType".
+ */
+type PlatformType$1 = 'posix' | 'container' | 'aws' | 'external';
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "GraphDatabaseType".
+ */
+type GraphDatabaseType = 'neo4j' | 'janusgraph' | 'neptune' | 'memory';
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "GraphServiceConfig".
+ */
+type GraphServiceConfig = {
+    [k: string]: unknown;
+} & {
+    platform: ServicePlatformConfig;
+    type: GraphDatabaseType;
+    name?: string;
+    uri?: string;
+    url?: string;
+    username?: string;
+    password?: string;
+    database?: string;
+    host?: string;
+    port?: number;
+    storage?: string;
+    index?: string;
+    endpoint?: string;
+    region?: string;
+    command?: string;
+    image?: string;
+    janusgraphVersion?: string;
+    javaOptions?: string;
+    heapSize?: string;
+    pageCacheSize?: string;
+    noAuth?: boolean;
+    dataPath?: string;
+    timeout?: number;
+    wait?: number;
+    logsEndpoint?: string;
+    tag?: string;
+    resources?: ResourceRequirements;
+    security?: SecurityRequirements;
+    build?: boolean | BuildRequirements;
+    dockerfile?: string;
+    buildContext?: string;
+    buildArgs?: {
+        [k: string]: string;
+    };
+    buildTarget?: string;
+    prebuilt?: boolean;
+    noCache?: boolean;
+    secrets?: string[];
+    labels?: {
+        [k: string]: string;
+    };
+    annotations?: {
+        [k: string]: string;
+    };
+    dependencies?: string[];
+    externalDependencies?: (string | {
+        name?: string;
+        url?: string;
+        required?: boolean;
+        healthCheck?: string;
+        [k: string]: unknown;
+    })[];
+    environment?: {
+        [k: string]: string;
+    };
+    env?: {
+        [k: string]: string;
+    };
+};
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "ServicePlatformConfig".
+ */
+interface ServicePlatformConfig {
+    type: PlatformType$1;
+    [k: string]: unknown;
+}
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "ResourceRequirements".
+ */
+interface ResourceRequirements {
+    cpu?: string;
+    memory?: string;
+    gpu?: number;
+    gpus?: number;
+    replicas?: number;
+    ephemeralStorage?: string;
+    memoryReservation?: string;
+}
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "SecurityRequirements".
+ */
+interface SecurityRequirements {
+    readOnlyRootFilesystem?: boolean;
+    runAsNonRoot?: boolean;
+    runAsUser?: number;
+    runAsGroup?: number;
+    capabilities?: string[] | {
+        add?: string[];
+        drop?: string[];
+        [k: string]: unknown;
+    };
+    privileged?: boolean;
+    allowPrivilegeEscalation?: boolean;
+}
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "BuildRequirements".
+ */
+interface BuildRequirements {
+    dockerfile?: string;
+    buildContext?: string;
+    buildArgs?: {
+        [k: string]: string;
+    };
+    buildTarget?: string;
+    prebuilt?: boolean;
+    noCache?: boolean;
+}
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "BackendServiceConfig".
+ */
+interface BackendServiceConfig {
+    platform: ServicePlatformConfig;
+    devMode?: boolean;
+    command?: string;
+    port: number;
+    publicURL: string;
+    corsOrigin: string;
+    image?: string;
+    cpu?: string;
+    memory?: string;
+    databaseUrl?: string;
+    projectRoot?: string;
+    timeout?: number;
+    wait?: number;
+    logsEndpoint?: string;
+    tag?: string;
+    resources?: ResourceRequirements;
+    security?: SecurityRequirements;
+    build?: boolean | BuildRequirements;
+    dockerfile?: string;
+    buildContext?: string;
+    buildArgs?: {
+        [k: string]: string;
+    };
+    buildTarget?: string;
+    prebuilt?: boolean;
+    noCache?: boolean;
+    secrets?: string[];
+    labels?: {
+        [k: string]: string;
+    };
+    annotations?: {
+        [k: string]: string;
+    };
+    dependencies?: string[];
+    externalDependencies?: (string | {
+        name?: string;
+        url?: string;
+        required?: boolean;
+        healthCheck?: string;
+        [k: string]: unknown;
+    })[];
+    redisUrl?: string;
+    environment?: {
+        [k: string]: string;
+    };
+    env?: {
+        [k: string]: string;
+    };
+}
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "FrontendServiceConfig".
+ */
+interface FrontendServiceConfig {
+    platform: ServicePlatformConfig;
+    devMode?: boolean;
+    command?: string;
+    port: number;
+    siteName: string;
+    image?: string;
+    projectRoot?: string;
+    databaseUrl?: string;
+    timeout?: number;
+    wait?: number;
+    logsEndpoint?: string;
+    tag?: string;
+    resources?: ResourceRequirements;
+    security?: SecurityRequirements;
+    build?: boolean | BuildRequirements;
+    dockerfile?: string;
+    buildContext?: string;
+    buildArgs?: {
+        [k: string]: string;
+    };
+    buildTarget?: string;
+    prebuilt?: boolean;
+    noCache?: boolean;
+    secrets?: string[];
+    labels?: {
+        [k: string]: string;
+    };
+    annotations?: {
+        [k: string]: string;
+    };
+    dependencies?: string[];
+    externalDependencies?: (string | {
+        name?: string;
+        url?: string;
+        required?: boolean;
+        healthCheck?: string;
+        [k: string]: unknown;
+    })[];
+    environment?: {
+        [k: string]: string;
+    };
+    env?: {
+        [k: string]: string;
+    };
+    publicURL?: string;
+    allowedOrigins?: string[];
+}
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "VectorsServiceConfig".
+ */
+interface VectorsServiceConfig {
+    platform?: ServicePlatformConfig;
+    type: 'qdrant' | 'memory';
+    host?: string;
+    port?: number;
+}
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "EmbeddingServiceConfig".
+ */
+interface EmbeddingServiceConfig {
+    platform?: ServicePlatformConfig;
+    type: 'voyage' | 'ollama';
+    model: string;
+    apiKey?: string;
+    baseURL?: string;
+    endpoint?: string;
+    chunking?: {
+        chunkSize?: number;
+        overlap?: number;
+        [k: string]: unknown;
+    };
+}
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "DatabaseServiceConfig".
+ */
+interface DatabaseServiceConfig {
+    platform: ServicePlatformConfig;
+    type: string;
+    name?: string;
+    host: string;
+    port: number;
+    environment?: {
+        [k: string]: string;
+    };
+    env?: {
+        [k: string]: string;
+    };
+    description?: string;
+    command?: string;
+    image?: string;
+    user?: string;
+    username?: string;
+    password?: string;
+    database?: string;
+    /**
+     * Override the default data storage directory ($XDG_DATA_HOME/semiont/{name}/database/{service})
+     */
+    dataDir?: string;
+    storageSize?: string;
+    timeout?: number;
+    wait?: number;
+    logsEndpoint?: string;
+    tag?: string;
+    resources?: ResourceRequirements;
+    security?: SecurityRequirements;
+    build?: boolean | BuildRequirements;
+    dockerfile?: string;
+    buildContext?: string;
+    buildArgs?: {
+        [k: string]: string;
+    };
+    buildTarget?: string;
+    prebuilt?: boolean;
+    noCache?: boolean;
+    secrets?: string[];
+    labels?: {
+        [k: string]: string;
+    };
+    annotations?: {
+        [k: string]: string;
+    };
+    dependencies?: string[];
+    externalDependencies?: (string | {
+        name?: string;
+        url?: string;
+        required?: boolean;
+        healthCheck?: string;
+        [k: string]: unknown;
+    })[];
+}
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "OllamaProviderConfig".
+ */
+interface OllamaProviderConfig {
+    platform: ServicePlatformConfig;
+    baseURL?: string;
+    port?: number;
+    image?: string;
+    command?: string;
+    timeout?: number;
+    wait?: number;
+    logsEndpoint?: string;
+}
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "AnthropicProviderConfig".
+ */
+interface AnthropicProviderConfig {
+    platform: 'external';
+    endpoint: string;
+    apiKey: string;
+}
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "InferenceProvidersConfig".
+ */
+interface InferenceProvidersConfig {
+    ollama?: OllamaProviderConfig;
+    anthropic?: AnthropicProviderConfig;
+    [k: string]: unknown;
+}
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "McpServiceConfig".
+ */
+interface McpServiceConfig {
+    platform: ServicePlatformConfig;
+    command?: string;
+    image?: string;
+    port?: number;
+    dependsOn?: string[];
+    timeout?: number;
+    wait?: number;
+    logsEndpoint?: string;
+    tag?: string;
+    resources?: ResourceRequirements;
+    security?: SecurityRequirements;
+    build?: boolean | BuildRequirements;
+    dockerfile?: string;
+    buildContext?: string;
+    buildArgs?: {
+        [k: string]: string;
+    };
+    buildTarget?: string;
+    prebuilt?: boolean;
+    noCache?: boolean;
+    secrets?: string[];
+    labels?: {
+        [k: string]: string;
+    };
+    annotations?: {
+        [k: string]: string;
+    };
+    dependencies?: string[];
+    externalDependencies?: (string | {
+        name?: string;
+        url?: string;
+        required?: boolean;
+        healthCheck?: string;
+        [k: string]: unknown;
+    })[];
+    environment?: {
+        [k: string]: string;
+    };
+    env?: {
+        [k: string]: string;
+    };
+}
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "ServicesConfig".
+ */
+interface ServicesConfig {
+    backend?: BackendServiceConfig;
+    frontend?: FrontendServiceConfig;
+    database?: DatabaseServiceConfig;
+    graph?: GraphServiceConfig;
+    mcp?: McpServiceConfig;
+    vectors?: VectorsServiceConfig;
+    embedding?: EmbeddingServiceConfig;
+    [k: string]: unknown;
+}
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "SiteConfig".
+ */
+interface SiteConfig {
+    /**
+     * Display name for the site
+     */
+    siteName?: string;
+    /**
+     * Primary domain for the site
+     */
+    domain: string;
+    /**
+     * Administrator email address
+     */
+    adminEmail?: string;
+    /**
+     * Support email address (optional)
+     */
+    supportEmail?: string;
+    /**
+     * Email domains allowed for OAuth authentication
+     *
+     * @minItems 1
+     */
+    oauthAllowedDomains?: [string, ...string[]];
+}
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "AppConfig".
+ */
+interface AppConfig {
+    features?: {
+        enableAnalytics?: boolean;
+        enableMaintenanceMode?: boolean;
+        enableDebugLogging?: boolean;
+    };
+    security?: {
+        /**
+         * Session timeout in seconds
+         */
+        sessionTimeout?: number;
+        /**
+         * Maximum failed login attempts before lockout
+         */
+        maxLoginAttempts?: number;
+        corsAllowedOrigins?: string[];
+        /**
+         * Enable local username/password authentication
+         */
+        enableLocalAuth?: boolean;
+        /**
+         * JWT signing secret (base64 encoded, 32+ bytes)
+         */
+        jwtSecret?: string;
+    };
+    performance?: {
+        enableCaching?: boolean;
+        /**
+         * Cache timeout in seconds
+         */
+        cacheTimeout?: number;
+        /**
+         * Maximum request size (e.g., '10mb')
+         */
+        maxRequestSize?: string;
+    };
+}
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "EnvironmentConfig".
+ */
+interface EnvironmentConfig {
+    /**
+     * Optional comment for documentation
+     */
+    _comment?: string;
+    _metadata?: {
+        environment: string;
+        projectRoot: string | null;
+        [k: string]: unknown;
+    };
+    /**
+     * Environment name
+     */
+    name?: string;
+    platform?: {
+        default?: PlatformType$1;
+        [k: string]: unknown;
+    };
+    services: ServicesConfig;
+    inference?: InferenceProvidersConfig;
+    workers?: {
+        [k: string]: {
+            inference?: {
+                type?: string;
+                model?: string;
+                [k: string]: unknown;
+            };
+            [k: string]: unknown;
+        };
+    };
+    actors?: {
+        [k: string]: {
+            inference?: {
+                type?: string;
+                model?: string;
+                [k: string]: unknown;
+            };
+            [k: string]: unknown;
+        };
+    };
+    site?: SiteConfig;
+    app?: AppConfig;
+    env?: {
+        NODE_ENV?: 'development' | 'production' | 'test';
+        [k: string]: unknown;
+    };
+    /**
+     * Logging verbosity level
+     */
+    logLevel?: 'error' | 'warn' | 'info' | 'http' | 'debug';
+    deployment?: {
+        imageTagStrategy?: 'mutable' | 'immutable' | 'git-hash';
+        [k: string]: unknown;
+    };
+    [k: string]: unknown;
+}
+/**
+ * This interface was referenced by `HttpsSemiontOrgSchemasConfigJson`'s JSON-Schema
+ * via the `definition` "SemiontConfig".
+ */
+interface SemiontConfig {
+    /**
+     * Config file version (semver)
+     */
+    version: string;
+    /**
+     * Project name
+     */
+    project: string;
+    site: SiteConfig;
+    app?: AppConfig;
+    services?: ServicesConfig;
+}
+
 /**
  * TOML Config Loader
  *
@@ -6025,4 +6625,5 @@ declare function getAllPlatformTypes(): PlatformType[];
 declare const CORE_TYPES_VERSION = "0.1.0";
 declare const SDK_VERSION = "0.1.0";
 
-export { type AccessToken, type Annotation, type AnnotationCategory, type AnnotationId, type AnnotationUri, type AssembledAnnotation, type AuthCode, BRIDGED_CHANNELS, type BackendDownload, type BaseUrl, type BodyItem, type BodyItemIdentity, type BodyOperation, type BoundingBox, type Brand, type BridgedChannel, type BurstBufferOptions, type BusOp, CHANNEL_SCHEMAS, CORE_TYPES_VERSION, CREATION_METHODS, type CloneToken, ConfigurationError, ConflictError, type ConnectionState, type ContentCache, type ContentFormat, type CreateAnnotationInternal, type CreationMethod, type Email, type EmittableChannel, type EntityType, type EntityTypeStats, type Environment, EnvironmentConfig, type EventBase, EventBus, type EventInput, type EventMap, type EventMetadata, type EventName, type EventOfType, type EventQuery, type EventSignature, type FragmentSelector, type GatheredContext, type GoogleAuthRequest, type GoogleCredential, type GraphConnection, type GraphPath, type HealthCheckResponse, type IBackendOperations, type IContentTransport, type ITransport, JWTTokenSchema, type JobId, LOCALES, type ListUsersResponse, type LocaleInfo, type Logger, type MCPToken, type MatchQuality, type MimeCategory, type Motivation, NotFoundError, PERSISTED_EVENT_TYPES, type PersistedEvent, type PersistedEventType, type PlatformType, type Point, type ProgressCallback, type ProgressEvent, type PutBinaryOptions, type PutBinaryProgress, type PutBinaryRequest, RESOURCE_BROADCAST_TYPES, type RefreshToken, type ResourceAnnotationUri, type ResourceAnnotations, type ResourceBroadcastType, type ResourceDescriptor, type ResourceFilter, type ResourceId, type ResourceUri, SDK_VERSION, ScopedEventBus, ScriptError, type SearchQuery, type SelectionData, type Selector, SemiontError, type StatusResponse, type StoredEvent, type StoredEventLike, type SvgSelector, type TagCategory, type TagSchema, type TextPosition, type TextPositionSelector, type TextQuoteSelector, type ActorInferenceConfig as TomlActorInferenceConfig, type TomlFileReader, type InferenceConfig as TomlInferenceConfig, type WorkerInferenceConfig as TomlWorkerInferenceConfig, type TransportErrorCode, UnauthorizedError, type UpdateResourceInput, type UpdateUserRequest, type UpdateUserResponse, type UserDID, type UserId, type UserResponse, type ValidatedAnnotation, ValidationError, type ValidationFailure, type ValidationResult, type ValidationSuccess, accessToken, annotationId, annotationUri, applyBodyOperations, assembleAnnotation, authCode, baseUrl, buildContentCache, burstBuffer, busLog, busLogEnabled, cloneToken, type components, createCircleSvg, createPolygonSvg, createRectangleSvg, createTomlConfigLoader, decodeRepresentation, decodeWithCharset, didToAgent, email, entityType, errField, extractBoundingBox, extractCharset, extractContext, findBestTextMatch, findBodyItem, findTextWithContext, formatLocaleDisplay, generateUuid, getAllLocaleCodes, getAllPlatformTypes, getAnnotationExactText, getAnnotationUriFromEvent, getBodySource, getBodyType, getChecksum, getCommentText, getCreator, getDerivedFrom, getExactText, getExtensionForMimeType, getFragmentSelector, getLanguage, getLocaleEnglishName, getLocaleInfo, getLocaleNativeName, getMimeCategory, getNodeEncoding, 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, isImageMimeType, isNull, isNullish, isNumber, isObject, isPdfMimeType, isReference, isResolvedReference, isResourceId, isStoredEvent, isString, isStubReference, isTag, isTextMimeType, isUndefined, isValidEmail, isValidPlatformType, jobId, loadTomlConfig, mcpToken, normalizeCoordinates, normalizeText, type operations, parseEnvironment, parseSvgSelector, type paths, refreshToken, resourceAnnotationUri, resourceId, resourceUri, scaleSvgToNative, searchQuery, serializePerKey, setBusLogTraceIdProvider, userDID, userId, userToAgent, userToDid, validateAndCorrectOffsets, validateData, validateEnvironment, validateSvgMarkup, verifyPosition };
+export { BRIDGED_CHANNELS, CHANNEL_SCHEMAS, CORE_TYPES_VERSION, ConfigurationError, ConflictError, EventBus, JWTTokenSchema, LOCALES, NotFoundError, PERSISTED_EVENT_TYPES, RESOURCE_BROADCAST_TYPES, SDK_VERSION, ScopedEventBus, ScriptError, SemiontError, UnauthorizedError, ValidationError, accessToken, agentToDid, annotationId, annotationUri, applyBodyOperations, assembleAnnotation, authCode, baseUrl, buildContentCache, burstBuffer, busLog, busLogEnabled, cloneToken, createCircleSvg, createPolygonSvg, createRectangleSvg, createTomlConfigLoader, decodeRepresentation, decodeWithCharset, didToAgent, email, entityType, errField, extractBoundingBox, extractCharset, extractContext, findBestTextMatch, findBodyItem, findTextWithContext, formatLocaleDisplay, generateUuid, getAllLocaleCodes, getAllPlatformTypes, getAnnotationExactText, getAnnotationUriFromEvent, getBodySource, getBodyType, getChecksum, getCommentText, getCreator, getDerivedFrom, getExactText, getExtensionForMimeType, getFragmentSelector, getLanguage, getLocaleEnglishName, getLocaleInfo, getLocaleNativeName, getMimeCategory, getNodeEncoding, 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, isImageMimeType, isNull, isNullish, isNumber, isObject, isPdfMimeType, isReference, isResolvedReference, isResourceId, isStoredEvent, isString, isStubReference, isTag, isTextMimeType, isUndefined, isValidEmail, isValidPlatformType, jobId, loadTomlConfig, mcpToken, normalizeCoordinates, normalizeText, parseEnvironment, parseSvgSelector, refreshToken, resourceAnnotationUri, resourceId, resourceUri, scaleSvgToNative, searchQuery, serializePerKey, setBusLogTraceIdProvider, softwareToAgent, userDID, userId, userToAgent, userToDid, validateAndCorrectOffsets, validateData, validateEnvironment, validateSvgMarkup, verifyPosition };
+export type { AccessToken, Annotation, AnnotationCategory, AnnotationId, AnnotationUri, AnthropicProviderConfig, AppConfig, AssembledAnnotation, AuthCode, BackendDownload, BackendServiceConfig, BaseUrl, BodyItem, BodyItemIdentity, BodyOperation, BoundingBox, Brand, BridgedChannel, BurstBufferOptions, BusOp, 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, HealthCheckResponse, IBackendOperations, IContentTransport, ITransport, InferenceProvidersConfig, JobId, ListUsersResponse, LocaleInfo, Logger, MCPToken, MatchQuality, McpServiceConfig, MimeCategory, Motivation, OllamaProviderConfig, PersistedEvent, PersistedEventType, PlatformType, Point, ProgressCallback, ProgressEvent, PutBinaryOptions, PutBinaryProgress, PutBinaryRequest, RefreshToken, ResourceAnnotationUri, ResourceAnnotations, ResourceBroadcastType, ResourceDescriptor, ResourceFilter, ResourceId, ResourceUri, SearchQuery, SelectionData, Selector, SemiontConfig, ServicePlatformConfig, ServicesConfig, SiteConfig, StatusResponse, StoredEvent, StoredEventLike, SvgSelector, TagCategory, TagSchema, TextPosition, TextPositionSelector, TextQuoteSelector, ActorInferenceConfig as TomlActorInferenceConfig, TomlFileReader, InferenceConfig as TomlInferenceConfig, WorkerInferenceConfig as TomlWorkerInferenceConfig, TransportErrorCode, UpdateResourceInput, UpdateUserRequest, UpdateUserResponse, UserDID, UserId, UserResponse, ValidatedAnnotation, ValidationFailure, ValidationResult, ValidationSuccess, VectorsServiceConfig, components, operations, paths };