Member Junction
    Preparing search index...

    Interface IContentSourceClassificationConfiguration

    Source-level classification-context extension to the CodeGen-generated MJContentSourceEntity_IContentSourceConfiguration interface.

    These two keys are NOT yet part of the generated JSON-type interface (a migration + CodeGen pass is required to add them there). We model them here as a typed extension so callers stay strongly-typed without touching generated code. The values are read defensively from the parsed Configuration JSON.

    interface IContentSourceClassificationConfiguration {
        ClassificationContext?: string;
        ClassificationContextMode?: ClassificationContextMode;
        EnableVectorization?: boolean;
        MaxCostPerRun?: number;
        MaxItemsPerRun?: number;
        MaxNewTagsPerItem?: number;
        MaxNewTagsPerRun?: number;
        MaxTokensPerRun?: number;
        ShareTaxonomyWithLLM?: boolean;
        SourceSpecificConfiguration?: Record<string, unknown>;
        SuggestThreshold?: number;
        TagMatchThreshold?: number;
        TagRootID?: string;
        TagTaxonomyMode?: "constrained" | "auto-grow" | "free-flow";
        Website?: MJContentSourceEntity_IContentSourceWebsiteConfiguration;
    }

    Hierarchy (View Summary)

    Index

    Properties

    ClassificationContext?: string

    Free-text guidance injected into the autotagging prompt at the SOURCE scope.

    ClassificationContextMode?: ClassificationContextMode

    How this source's context combines with the org/type scopes. Defaults to 'additive'.

    EnableVectorization?: boolean

    Enable vectorization for this source. Default true

    MaxCostPerRun?: number

    Maximum cumulative cost (USD) the run may incur before pausing. NULL/unset = unlimited.

    MaxItemsPerRun?: number

    Maximum number of content items the autotagger may PROCESS (hand to the LLM) per run before the run is paused via the existing CancellationRequested machinery. Does not include items skipped by change-detection — those are free. NULL/unset = unlimited.

    Most intuitive "do at most N this run, do the rest next time" knob. When checking budgets after a batch, this is evaluated FIRST (before tag / token / cost caps) because it is the most user-facing and not tied to a specific model's pricing or tokenization.

    Pause is graceful — the next invocation re-crawls, change-detection skips the items already tagged in DB, and the remaining items get processed.

    MaxNewTagsPerItem?: number

    Maximum number of new tags the autotagger may auto-create for a single ContentItem. Once reached, further free-text tags from that item are routed to MJ:Tag Suggestions with Reason='MaxItemTagsExceeded' instead of being created. NULL/unset = unlimited.

    MaxNewTagsPerRun?: number

    Maximum number of new tags the autotagger may auto-create across an entire run before the run is paused via the existing CancellationRequested machinery. NULL/unset = unlimited. Pause is graceful — the run resumes from LastProcessedOffset when restarted.

    MaxTokensPerRun?: number

    Maximum cumulative LLM tokens (prompt + completion) the run may consume before pausing. Reads from ContentProcessRunDetail.TotalTokensUsed rollup. NULL/unset = unlimited.

    ShareTaxonomyWithLLM?: boolean

    Whether to share existing tag taxonomy with the LLM during autotagging. Default true

    SourceSpecificConfiguration?: Record<string, unknown>

    Source-type-specific configuration values. The keys here correspond to the RequiredFields[].Key values defined on the parent ContentSourceType's Configuration.

    Examples:

    • Entity type: { EntityID: "uuid", EntityDocumentID: "uuid" }
    • RSS Feed: { URL: "https://example.com/feed.xml" }
    • Cloud Storage: { FileStorageProviderKey: "Azure Blob Storage", PathPrefix: "/documents" }
    • Local File System: { Path: "/var/data/documents" }
    • Website: { URL: "https://example.com" } — see Website sub-object below for crawl knobs
    SuggestThreshold?: number

    Lower confidence band (0.0-1.0) that routes a semantic match into the human-in-the-loop MJ:Tag Suggestions queue instead of auto-applying or auto-creating. A score s is routed as: s >= TagMatchThreshold → apply; SuggestThreshold <= s < TagMatchThreshold → enqueue suggestion (Reason='BelowThreshold'); s < SuggestThreshold → fall through to handleNoMatch (governed by TagTaxonomyMode). When unset, defaults to TagMatchThreshold - 0.05 at runtime.

    TagMatchThreshold?: number

    Similarity threshold (0.0-1.0) for matching ContentItemTags to formal Tags. Default 0.9

    TagRootID?: string

    Root Tag ID for constrained/auto-grow modes — limits taxonomy operations to this subtree

    TagTaxonomyMode?: "constrained" | "auto-grow" | "free-flow"

    Tag taxonomy matching mode: constrained (only match within subtree), auto-grow (match or create within subtree), free-flow (match or create anywhere)

    Website-crawler settings — only meaningful for content sources whose ContentSourceType is "Website". Replaces the legacy per-key ContentSourceParam rows; AutotagWebsite reads from this sub-object first and falls back to ContentSourceParam rows for sources configured before this field existed.

    In the future, source-type-specific knobs like these may move to a pluggable per-source-type sub-interface scheme (one named property per source type). This is the first opt-in implementation; other source types will follow the same pattern as their knobs grow.