stateful-mcp 0.1.1

package/dist/src/config/types.d.ts

@@ -0,0 +1,152 @@
+export type ResourceLocator = {
+    _type: "adapter";
+    name: string;
+    options?: Record<string, unknown>;
+} | {
+    _type: "file";
+    path: string;
+    ttl_ms?: number;
+} | {
+    _type: "remote_url";
+    url: string;
+    ttl_ms?: number;
+    headers?: Record<string, string>;
+};
+export type OwnerScope = {
+    level: "global";
+} | {
+    level: "user";
+    userId: string;
+};
+export interface ToolConfig {
+    schema: ResourceLocator;
+    translation?: ResourceLocator;
+    engine: ResourceLocator | Record<string, ResourceLocator>;
+    validation_engine?: ResourceLocator;
+    inspect?: {
+        expose_compiled?: boolean;
+    };
+}
+export interface AutoCompressionConfig {
+    filter_chain_threshold?: number;
+    object_chain_threshold?: number;
+}
+export interface PaginationLimitsConfig {
+    /** Max entries per log page (log_open / log_next). */
+    log_page_size?: number;
+    /** Max examples returned per page by *_examples tools.  */
+    examples_page_size?: number;
+    /** Max conflicts returned per page by event_merge_inspect. */
+    merge_conflicts_page_size?: number;
+}
+export interface MiddlewareConfig {
+    $schema?: string;
+    version: 1;
+    filter_session_state: ResourceLocator;
+    filter_persistent_state: {
+        global: ResourceLocator;
+        user: ResourceLocator;
+    };
+    object_session_state: ResourceLocator;
+    object_persistent_state: {
+        global: ResourceLocator;
+        user: ResourceLocator;
+    };
+    event_session_state?: ResourceLocator;
+    event_persistent_state?: {
+        global: ResourceLocator;
+        user: ResourceLocator;
+    };
+    form_session_state?: ResourceLocator;
+    form_persistent_state?: {
+        global: ResourceLocator;
+        user: ResourceLocator;
+    };
+    dictionary_state: ResourceLocator;
+    dictionary_resolver: ResourceLocator;
+    auto_compression?: AutoCompressionConfig;
+    constants?: {
+        global?: ResourceLocator;
+        user?: ResourceLocator;
+    };
+    object_schemas?: Record<string, ResourceLocator | {
+        schema: ResourceLocator;
+        validation_engine?: ResourceLocator;
+    }>;
+    object_schema_limits?: {
+        max_fields_per_def?: number;
+        max_ref_depth?: number;
+    };
+    pagination_limits?: PaginationLimitsConfig;
+    form_schemas?: Record<string, ResourceLocator | {
+        schema: ResourceLocator;
+    }>;
+    tools: Record<string, ToolConfig>;
+    env_sources?: Array<ResourceLocator & {
+        optional?: boolean;
+    }>;
+    about_and_examples?: AboutAndExamplesConfig;
+}
+export interface AboutAndExamplesConfig {
+    middleware_about?: ResourceLocator[];
+    filter_about?: ResourceLocator[];
+    filter_examples?: ResourceLocator[];
+    object_about?: ResourceLocator[];
+    object_examples?: ResourceLocator[];
+    dictionary_about?: ResourceLocator[];
+    dictionary_examples?: ResourceLocator[];
+    event_about?: ResourceLocator[];
+    event_examples?: ResourceLocator[];
+    form_about?: ResourceLocator[];
+    form_examples?: ResourceLocator[];
+}
+export interface TableSchema {
+    filterable_properties: string[];
+    operators: string[];
+    groupable_columns?: string[];
+    aggregations?: string[];
+    result_shape?: string;
+    max_results?: number;
+    mock_dataset?: any[];
+}
+export interface ToolSchema {
+    primary_table?: string;
+    available_tables: string[];
+    table_schemas: Record<string, TableSchema>;
+}
+export interface FormNextRule {
+    condition?: {
+        operator: string;
+        value: any;
+    };
+    target: string | null;
+}
+export interface FormQuestion {
+    text: string;
+    answer_type: "boolean" | "free_text" | "multiple_choice" | "scale" | "number" | "date" | "multi_select" | "ranked";
+    required?: boolean;
+    options?: string[];
+    scale?: {
+        min: number;
+        max: number;
+        step?: number;
+    };
+    next?: FormNextRule[] | {
+        default: string | null;
+    } | Record<string, string | null>;
+}
+export interface FormSection {
+    title: string;
+    questions: string[];
+    next?: {
+        default: string | null;
+    } | FormNextRule[];
+}
+export interface FormSchema {
+    form_id: string;
+    sections?: Record<string, FormSection>;
+    questions: Record<string, FormQuestion>;
+    start_section?: string;
+    start_question: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/config/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/config/types.ts"],"names":[],"mappings":"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"}

package/dist/src/config/types.js

@@ -0,0 +1 @@
+// @bun

package/dist/src/config/validator.d.ts

@@ -0,0 +1,3 @@
+import type { MiddlewareConfig } from "./types";
+export declare function validateMiddlewareConfig(config: any): asserts config is MiddlewareConfig;
+//# sourceMappingURL=validator.d.ts.map

package/dist/src/config/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../src/config/validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAA+B,MAAM,SAAS,CAAC;AA2B7E,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,IAAI,gBAAgB,CAwJxF"}

package/dist/src/errors/format.d.ts

@@ -0,0 +1,8 @@
+export declare function formatErrorResponse(err: unknown): {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError: boolean;
+};
+//# sourceMappingURL=format.d.ts.map

package/dist/src/errors/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/errors/format.ts"],"names":[],"mappings":"AAEA,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO;;;;;;EAkC/C"}

package/dist/src/errors/types.d.ts

@@ -0,0 +1,32 @@
+export declare enum ErrorCode {
+    CONFIG_INVALID = "CONFIG_INVALID",
+    ADAPTER_NOT_REGISTERED = "ADAPTER_NOT_REGISTERED",
+    SCHEMA_LOAD_FAILED = "SCHEMA_LOAD_FAILED",
+    TRANSLATION_CYCLE = "TRANSLATION_CYCLE",
+    FILTER_NOT_FOUND = "FILTER_NOT_FOUND",
+    FILTER_PROPERTY_INVALID = "FILTER_PROPERTY_INVALID",
+    FILTER_OPERATOR_INVALID = "FILTER_OPERATOR_INVALID",
+    FILTER_COMBINATION_INVALID = "FILTER_COMBINATION_INVALID",
+    FILTER_SCOPE_INVALID = "FILTER_SCOPE_INVALID",
+    FILTER_PRIVILEGE_DENIED = "FILTER_PRIVILEGE_DENIED",
+    CONCEPT_NOT_FOUND = "CONCEPT_NOT_FOUND",
+    CONCEPT_ALLOCATION_FAILED = "CONCEPT_ALLOCATION_FAILED",
+    EXPRESSION_INVALID = "EXPRESSION_INVALID",
+    RESOLVE_NO_MATCH = "RESOLVE_NO_MATCH",
+    DICTIONARY_MUTATION_DENIED = "DICTIONARY_MUTATION_DENIED",
+    OBJECT_NOT_FOUND = "OBJECT_NOT_FOUND",
+    OBJECT_PATH_INVALID = "OBJECT_PATH_INVALID",
+    OBJECT_TYPE_MISMATCH = "OBJECT_TYPE_MISMATCH",
+    OBJECT_VALIDATION_FAILED = "OBJECT_VALIDATION_FAILED",
+    OBJECT_CYCLE_DETECTED = "OBJECT_CYCLE_DETECTED",
+    OBJECT_SCHEMA_EXCEEDED = "OBJECT_SCHEMA_EXCEEDED",
+    EXECUTION_FAILED = "EXECUTION_FAILED",
+    INTERNAL_ERROR = "INTERNAL_ERROR",
+    SCHEMA_MISMATCH = "SCHEMA_MISMATCH"
+}
+export declare class McpError extends Error {
+    readonly code: ErrorCode;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(code: ErrorCode, message: string, details?: Record<string, unknown> | undefined);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/errors/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/errors/types.ts"],"names":[],"mappings":"AAAA,oBAAY,SAAS;IAEnB,cAAc,mBAA8B;IAC5C,sBAAsB,2BAA8B;IACpD,kBAAkB,uBAA8B;IAChD,iBAAiB,sBAA8B;IAG/C,gBAAgB,qBAA8B;IAC9C,uBAAuB,4BAA8B;IACrD,uBAAuB,4BAA8B;IACrD,0BAA0B,+BAA+B;IACzD,oBAAoB,yBAA8B;IAClD,uBAAuB,4BAA8B;IAGrD,iBAAiB,sBAA8B;IAC/C,yBAAyB,8BAA8B;IACvD,kBAAkB,uBAA8B;IAChD,gBAAgB,qBAA8B;IAC9C,0BAA0B,+BAA+B;IAGzD,gBAAgB,qBAA8B;IAC9C,mBAAmB,wBAA8B;IACjD,oBAAoB,yBAA8B;IAClD,wBAAwB,6BAA8B;IACtD,qBAAqB,0BAA8B;IACnD,sBAAsB,2BAA8B;IAGpD,gBAAgB,qBAA8B;IAG9C,cAAc,mBAA8B;IAC5C,eAAe,oBAA8B;CAC9C;AAED,qBAAa,QAAS,SAAQ,KAAK;aAEf,IAAI,EAAE,SAAS;aAEf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFjC,IAAI,EAAE,SAAS,EAC/B,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAKpD"}

package/dist/src/errors/types.js

@@ -0,0 +1,44 @@
+// @bun
+// src/errors/types.ts
+var ErrorCode;
+((ErrorCode2) => {
+  ErrorCode2["CONFIG_INVALID"] = "CONFIG_INVALID";
+  ErrorCode2["ADAPTER_NOT_REGISTERED"] = "ADAPTER_NOT_REGISTERED";
+  ErrorCode2["SCHEMA_LOAD_FAILED"] = "SCHEMA_LOAD_FAILED";
+  ErrorCode2["TRANSLATION_CYCLE"] = "TRANSLATION_CYCLE";
+  ErrorCode2["FILTER_NOT_FOUND"] = "FILTER_NOT_FOUND";
+  ErrorCode2["FILTER_PROPERTY_INVALID"] = "FILTER_PROPERTY_INVALID";
+  ErrorCode2["FILTER_OPERATOR_INVALID"] = "FILTER_OPERATOR_INVALID";
+  ErrorCode2["FILTER_COMBINATION_INVALID"] = "FILTER_COMBINATION_INVALID";
+  ErrorCode2["FILTER_SCOPE_INVALID"] = "FILTER_SCOPE_INVALID";
+  ErrorCode2["FILTER_PRIVILEGE_DENIED"] = "FILTER_PRIVILEGE_DENIED";
+  ErrorCode2["CONCEPT_NOT_FOUND"] = "CONCEPT_NOT_FOUND";
+  ErrorCode2["CONCEPT_ALLOCATION_FAILED"] = "CONCEPT_ALLOCATION_FAILED";
+  ErrorCode2["EXPRESSION_INVALID"] = "EXPRESSION_INVALID";
+  ErrorCode2["RESOLVE_NO_MATCH"] = "RESOLVE_NO_MATCH";
+  ErrorCode2["DICTIONARY_MUTATION_DENIED"] = "DICTIONARY_MUTATION_DENIED";
+  ErrorCode2["OBJECT_NOT_FOUND"] = "OBJECT_NOT_FOUND";
+  ErrorCode2["OBJECT_PATH_INVALID"] = "OBJECT_PATH_INVALID";
+  ErrorCode2["OBJECT_TYPE_MISMATCH"] = "OBJECT_TYPE_MISMATCH";
+  ErrorCode2["OBJECT_VALIDATION_FAILED"] = "OBJECT_VALIDATION_FAILED";
+  ErrorCode2["OBJECT_CYCLE_DETECTED"] = "OBJECT_CYCLE_DETECTED";
+  ErrorCode2["OBJECT_SCHEMA_EXCEEDED"] = "OBJECT_SCHEMA_EXCEEDED";
+  ErrorCode2["EXECUTION_FAILED"] = "EXECUTION_FAILED";
+  ErrorCode2["INTERNAL_ERROR"] = "INTERNAL_ERROR";
+  ErrorCode2["SCHEMA_MISMATCH"] = "SCHEMA_MISMATCH";
+})(ErrorCode ||= {});
+
+class McpError extends Error {
+  code;
+  details;
+  constructor(code, message, details) {
+    super(message);
+    this.code = code;
+    this.details = details;
+    this.name = "McpError";
+  }
+}
+export {
+  McpError,
+  ErrorCode
+};

package/dist/src/middleware/dictionary/interfaces.d.ts

@@ -0,0 +1,43 @@
+import type { Concept, CustomExpression, Namespace } from "./types";
+import type { OwnerScope } from "../../config/types";
+export interface ConceptStore {
+    /**
+     * Search concepts by term, matching ID, code, display, or description.
+     */
+    search(query: string, namespaceCode?: string, limit?: number): Promise<Concept[]>;
+    /**
+     * Retrieve a single concept by ID.
+     */
+    getById(id: string): Promise<Concept | null>;
+    /**
+     * List all namespaces.
+     */
+    listNamespaces(): Promise<Namespace[]>;
+    /**
+     * Optional helper to add concepts (for setup and compliance testing).
+     */
+    addConcept(concept: Concept): Promise<void>;
+    /**
+     * Optional helper to add namespaces.
+     */
+    addNamespace(namespace: Namespace): Promise<void>;
+}
+export interface PersistentExpressionStore {
+    /**
+     * Save a custom abbreviation/expression in the database.
+     */
+    save(expression: CustomExpression, scope: OwnerScope): Promise<void>;
+    /**
+     * Delete a custom expression from the database.
+     */
+    delete(id: string, scope: OwnerScope): Promise<void>;
+    /**
+     * List all custom expressions visible to this scope.
+     */
+    list(scope: OwnerScope, includeGlobal?: boolean): Promise<CustomExpression[]>;
+    /**
+     * Retrieve a single custom expression by ID (for permission/existence checking).
+     */
+    getById(id: string): Promise<CustomExpression | null>;
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/src/middleware/dictionary/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../../../src/middleware/dictionary/interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAElF;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAE7C;;OAEG;IACH,cAAc,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAEvC;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5C;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,IAAI,CAAC,UAAU,EAAE,gBAAgB,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErE;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErD;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAE9E;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;CACvD"}

package/dist/src/middleware/dictionary/resolver.d.ts

@@ -0,0 +1,47 @@
+import type { Concept, CustomExpression, ResolutionMetric } from "./types";
+import type { ConceptStore, PersistentExpressionStore } from "./interfaces";
+export type ResolutionStatus = 'FOUND' | 'PARTIAL' | 'NOT_FOUND';
+export interface AggregatedResult {
+    conceptId: string;
+    concept: Concept;
+    score: number;
+    matchedTerms: string[];
+    sources: string[];
+}
+export interface ResolveResponse {
+    status: ResolutionStatus;
+    sources: string[];
+    results: AggregatedResult[];
+}
+export interface ResolveResult {
+    conceptId: string;
+    concept: Concept;
+    expression: CustomExpression;
+    score: number;
+}
+export interface ConceptResolver {
+    resolve(term: string, concepts: ConceptStore | Map<string, Concept>, expressions: PersistentExpressionStore | CustomExpression[], metrics: ResolutionMetric[], context?: Record<string, any>): Promise<ResolveResponse>;
+}
+export declare class InMemoryConceptResolver implements ConceptResolver {
+    private getExpressionScopeLevel;
+    private getExpressionScopeLevelNumeric;
+    private matchesContext;
+    resolve(term: string, concepts: ConceptStore | Map<string, Concept>, expressions: PersistentExpressionStore | CustomExpression[], metrics: ResolutionMetric[], context?: Record<string, any>): Promise<ResolveResponse>;
+}
+import type { BackendWeightConfig } from "./types";
+export interface BackendInstance {
+    config: BackendWeightConfig;
+    currentWeight: number;
+    resolver: ConceptResolver;
+    concepts: Map<string, Concept>;
+    expressions: CustomExpression[];
+    metrics: ResolutionMetric[];
+}
+export declare class MultiBackendConceptResolver implements ConceptResolver {
+    private backends;
+    constructor(backends: BackendInstance[]);
+    getBackends(): BackendInstance[];
+    adjustWeight(backendId: string, adjustment: number): void;
+    resolve(term: string, concepts: Map<string, Concept>, expressions: CustomExpression[], metrics: ResolutionMetric[], context?: Record<string, any>): Promise<ResolveResponse>;
+}
+//# sourceMappingURL=resolver.d.ts.map

package/dist/src/middleware/dictionary/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../../../src/middleware/dictionary/resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAa,MAAM,SAAS,CAAC;AACtF,OAAO,KAAK,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AA0D5E,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,CAAC;AAEjE,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,CACL,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,YAAY,GAAG,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7C,WAAW,EAAE,yBAAyB,GAAG,gBAAgB,EAAE,EAC3D,OAAO,EAAE,gBAAgB,EAAE,EAC3B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC5B,OAAO,CAAC,eAAe,CAAC,CAAC;CAC7B;AAED,qBAAa,uBAAwB,YAAW,eAAe;IAC7D,OAAO,CAAC,uBAAuB;IAM/B,OAAO,CAAC,8BAA8B;IAOtC,OAAO,CAAC,cAAc;IAcT,OAAO,CAClB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,YAAY,GAAG,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7C,WAAW,EAAE,yBAAyB,GAAG,gBAAgB,EAAE,EAC3D,OAAO,EAAE,gBAAgB,EAAE,EAC3B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC5B,OAAO,CAAC,eAAe,CAAC;CA2G5B;AAED,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,mBAAmB,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED,qBAAa,2BAA4B,YAAW,eAAe;IACrD,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,eAAe,EAAE;IAExC,WAAW,IAAI,eAAe,EAAE;IAIhC,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;IAc5C,OAAO,CAClB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,WAAW,EAAE,gBAAgB,EAAE,EAC/B,OAAO,EAAE,gBAAgB,EAAE,EAC3B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC5B,OAAO,CAAC,eAAe,CAAC;CAyF5B"}

package/dist/src/middleware/dictionary/store.d.ts

@@ -0,0 +1,73 @@
+import type { Namespace, Concept, ConceptRelation, CustomExpression, ResolutionMetric, DictionaryConfig, WorkspaceDefinition } from "./types";
+import type { ConceptResolver } from "./resolver";
+import type { ConceptStore, PersistentExpressionStore } from "./interfaces";
+import type { OwnerScope } from "../../config/types";
+export declare class InMemoryConceptStore implements ConceptStore {
+    private namespaces;
+    private concepts;
+    search(query: string, namespaceCode?: string, limit?: number): Promise<Concept[]>;
+    getById(id: string): Promise<Concept | null>;
+    listNamespaces(): Promise<Namespace[]>;
+    addConcept(concept: Concept): Promise<void>;
+    addNamespace(namespace: Namespace): Promise<void>;
+}
+export declare class InMemoryPersistentExpressionStore implements PersistentExpressionStore {
+    private expressions;
+    save(expression: CustomExpression, scope: OwnerScope): Promise<void>;
+    delete(id: string, scope: OwnerScope): Promise<void>;
+    list(scope: OwnerScope, includeGlobal?: boolean): Promise<CustomExpression[]>;
+    getById(id: string): Promise<CustomExpression | null>;
+}
+export declare class DictionaryStore {
+    private resolver;
+    private conceptStore;
+    private expressionStore;
+    private relations;
+    private metrics;
+    private allowedTargetAssignments?;
+    private workspaces;
+    private allowedTags?;
+    private exposeTagsAsEnum;
+    private defaultDynamicNamespace;
+    private defaultWorkspaceId;
+    private exposeWorkspaceAsEnum;
+    constructor(resolver: ConceptResolver, conceptStore?: ConceptStore, expressionStore?: PersistentExpressionStore);
+    loadConfig(config: DictionaryConfig): Promise<void>;
+    shouldExposeWorkspaceAsEnum(): boolean;
+    getDefaultWorkspace(): string;
+    getWorkspaces(): WorkspaceDefinition[];
+    resolveConceptId(ref: string): Promise<string | undefined>;
+    getAllowedTags(): string[];
+    shouldExposeTagsAsEnum(): boolean;
+    getDefaultDynamicNamespace(): string;
+    addNamespace(ns: Namespace): Promise<void>;
+    getNamespace(code: string): Promise<Namespace | undefined>;
+    private verifyNamespaceMutable;
+    private checkScopeAccess;
+    addConcept(c: Omit<Concept, "id"> & {
+        id?: string;
+    }): Promise<string>;
+    editConcept(id: string, updates: Partial<Concept>, callerContext?: Record<string, any>): Promise<void>;
+    removeConcept(id: string, callerContext?: Record<string, any>): Promise<void>;
+    getConcept(id: string): Promise<Concept | undefined>;
+    addRelation(rel: ConceptRelation): Promise<void>;
+    removeRelation(id: string, callerContext?: Record<string, any>): Promise<void>;
+    getRelations(): ConceptRelation[];
+    addExpression(expr: Omit<CustomExpression, "id"> & {
+        id?: string;
+    }, callerContext?: Record<string, any>): Promise<string>;
+    editExpression(id: string, updates: Partial<CustomExpression>, callerContext?: Record<string, any>): Promise<void>;
+    removeExpression(id: string, callerContext?: Record<string, any>): Promise<boolean>;
+    getExpressions(scope?: OwnerScope): Promise<CustomExpression[]>;
+    private getExpressionScopeLevel;
+    private matchesContext;
+    resolve(term: string, context?: Record<string, any>): Promise<any>;
+    find(query: {
+        term?: string;
+        tags?: string[];
+        conceptType?: string;
+    }, context?: Record<string, any>): Promise<CustomExpression[]>;
+    recordUsage(expressionId: string, conceptId: string, context: Record<string, any>): void;
+    getMetrics(): ResolutionMetric[];
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/src/middleware/dictionary/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../../src/middleware/dictionary/store.ts"],"names":[],"mappings":"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"}

package/dist/src/middleware/dictionary/types.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Defines a specific dictionary or terminology source (e.g., SNOMED, ICD-10).
+ */
+export interface Namespace {
+    /** Unique classification code for the namespace (e.g., 'SNOMED', 'ICD-10') */
+    code: string;
+    /** Human-readable explanation of the terminology database scope */
+    description?: string;
+    /** If true, the namespace is openly queryable by any user or context */
+    isPublic: boolean;
+    /** If true, data resides in an external private store requiring authentication */
+    isExternalPrivate: boolean;
+    /** If true, user can add/edit/remove entries in this namespace */
+    isMutable?: boolean;
+    /** Identifier/name of the private database or integration connector */
+    externalPrivateSource?: string;
+    /** Endpoint URL for external REST/GraphQL concept lookup APIs */
+    apiUrl?: string;
+    /** Static query string parameters or path segments for the lookup request */
+    apiUrlParams?: Record<string, any>;
+    /** Default request body JSON payload structure sent to the external API */
+    apiRequestPayload?: Record<string, any>;
+    /** JSON-path mapping key to retrieve the display name from the API JSON response */
+    apiResponseDisplayPath?: string;
+}
+/**
+ * Represents a single canonical concept or standard code coordinate within a coding system.
+ */
+export interface Concept {
+    /** Unique concept ID (e.g., UUID) */
+    id: string;
+    /** The namespace identifier this concept belongs to (e.g., 'SNOMED') */
+    namespaceCode: string;
+    /** The canonical coordinate/code value (e.g., 'I21.9' or 'R06.02') */
+    standardCode: string;
+    /** Default user-friendly fallback display label for the concept code */
+    display: string;
+    /** Semantic description or clinical explanation of the concept definition */
+    description?: string;
+    /** Optional date stamp indicating when the concept was assigned or declared */
+    designationDate?: string;
+    /** If false, the concept is deactivated and ignored during resolution */
+    active?: boolean;
+}
+/** Semantic mapping relationships linking two different concepts */
+export type ConceptRelationType = 'EQUIVALENT' | 'NARROWER_THAN' | 'WIDER_THAN';
+/**
+ * Declares relationships between two different concepts (e.g. mapping synonyms or hierarchies).
+ */
+export interface ConceptRelation {
+    /** Unique relationship record identifier */
+    id: string;
+    /** Source concept ID in the relationship */
+    conceptId: string;
+    /** Target concept ID linked to the source concept */
+    linkedId: string;
+    /** The semantic nature of the link (e.g., EQUIVALENT mapping) */
+    relationshipType: ConceptRelationType;
+    /** If false, the relation link is disabled and ignored */
+    active: boolean;
+    /** Optional date stamp of when the relationship was designated */
+    designationDate?: string;
+}
+/** Classification defining the type of target assignment (e.g. 'MAIN_TERM' or 'METRIC') */
+export type TargetAssignment = string;
+/**
+ * Defines a custom keyword pattern or alias mapping to map shorthand terms to concepts.
+ */
+export interface CustomExpression {
+    /** Unique expression mapping record identifier */
+    id: string;
+    /** Default readable shorthand term or alias (e.g. 'heart attack') */
+    term: string;
+    /** Regex pattern compiled dynamically to evaluate match candidates */
+    regexPattern: string;
+    /** If true, regex matches ignore letter casing (case-insensitive flag) */
+    isCaseInsensitive: boolean;
+    /** Domain-specific role/assignment classification for this expression */
+    targetAssignment: TargetAssignment;
+    /** The target Concept ID this expression resolves/maps to */
+    conceptId?: string;
+    /** Static base scoring priority (higher values rank higher) */
+    priorityWeight: number;
+    /** If false, the expression mapping is ignored during resolution */
+    active: boolean;
+    /** Custom generic metadata dictionary (e.g. tags, workspace_id, description) */
+    context?: Record<string, any>;
+}
+/**
+ * Tracks historical statistics and metrics for resolved expressions.
+ */
+export interface ResolutionMetric {
+    /** The custom expression ID that was successfully matched */
+    expressionId: string;
+    /** The concept ID that the expression resolved to */
+    conceptId: string;
+    /** Session/workspace context under which resolution took place */
+    context: Record<string, any>;
+    /** Total number of times this specific resolution mapping has been used */
+    usageCount: number;
+    /** ISO timestamp of the last successful resolution of this mapping */
+    lastResolvedAt: string;
+}
+export interface WorkspaceDefinition {
+    /** Unique workspace identifier code */
+    id: string;
+    /** Human-friendly name of the workspace */
+    name: string;
+    /** Detailed description of this workspace's purpose */
+    description?: string;
+}
+/**
+ * Configuration payload containing lists of initial dictionary elements to load.
+ */
+export interface DictionaryConfig {
+    /** List of predefined terminology namespaces to populate */
+    namespaces?: Namespace[];
+    /** List of pre-seeded canonical concepts to load */
+    concepts?: Concept[];
+    /** List of semantic concept relationships to configure */
+    relations?: ConceptRelation[];
+    /** Pre-seeded shorthand-to-concept expression mappings */
+    expressions?: CustomExpression[];
+    /** List of allowed values for targetAssignment validation */
+    allowedTargetAssignments?: string[];
+    /** The default namespace identifier used for newly registered dynamic concepts */
+    defaultDynamicNamespace?: string;
+    /** Predefined set of valid workspace scopes */
+    workspaces?: WorkspaceDefinition[];
+    /** Predefined set of allowed entry tags */
+    allowedTags?: string[];
+    /** Flag to determine whether valid tags should be strictly exposed as an enum to the LLM */
+    exposeTagsAsEnum?: boolean;
+    /** The default workspace ID assigned when no workspace context is provided */
+    defaultWorkspaceId?: string;
+    /** Flag to determine whether valid workspaces should be strictly exposed as an enum to the LLM */
+    exposeWorkspaceAsEnum?: boolean;
+}
+/**
+ * Weight boundary configurations for a single dictionary resolution source.
+ */
+export interface BackendWeightConfig {
+    /** Unique identifier for the resolution backend (e.g., 'personal', 'global') */
+    id: string;
+    /** Default scaling multiplier applied to candidate match scores */
+    defaultWeight: number;
+    /** Lower limit boundary preventing weight decay from dropping below a threshold */
+    minWeight?: number;
+    /** Upper limit boundary capping maximum weight growth on rewards */
+    maxWeight?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/middleware/dictionary/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/middleware/dictionary/types.ts"],"names":[],"mappings":"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"}