stateful-mcp 0.1.1

package/dist/src/adapters/storage/memory-repo.d.ts

@@ -0,0 +1,129 @@
+import type { OwnerScope } from "../../config/types";
+import type { FilterState } from "../../middleware/filter/types";
+import type { ObjectState } from "../../middleware/object/types";
+import type { EventCommit } from "../../middleware/event/types";
+import type { SessionFilterStore, PersistentFilterStore, PersistedFilterState, SessionObjectStore, PersistentObjectStore, PersistedObjectState, SessionEventStore, PersistentEventStore, PersistedEventState, SessionFormStore, PersistentFormStore, PersistedFormStateDetails } from "./interfaces";
+import type { FormState } from "../../middleware/form/types";
+export declare class MemorySessionFilterStore implements SessionFilterStore {
+    private store;
+    private aliases;
+    getAlias(sessionId: string, alias: string): Promise<string | null>;
+    setAlias(sessionId: string, alias: string, targetId: string): Promise<void>;
+    deleteAlias(sessionId: string, alias: string): Promise<void>;
+    listAliases(sessionId: string): Promise<Array<{
+        alias: string;
+        targetId: string;
+    }>>;
+    create(sessionId: string, state: Omit<FilterState, "filterId"> & {
+        filterId?: string;
+    }, alias?: string): Promise<string>;
+    get(sessionId: string, id: string): Promise<FilterState | null>;
+    set(sessionId: string, id: string, state: FilterState): Promise<void>;
+    delete(sessionId: string, id: string): Promise<void>;
+    listSession(sessionId: string): Promise<string[]>;
+    listChildren(sessionId: string, parentId: string): Promise<string[]>;
+    expireSession(sessionId: string, olderThanMs?: number): Promise<void>;
+}
+export declare class MemoryPersistentFilterStore implements PersistentFilterStore {
+    private store;
+    private getScopeKey;
+    get(id: string, scope: OwnerScope): Promise<PersistedFilterState | null>;
+    set(id: string, state: PersistedFilterState, scope: OwnerScope): Promise<void>;
+    delete(id: string, scope: OwnerScope): Promise<void>;
+    findByTag(tag: string, scope: OwnerScope): Promise<PersistedFilterState[]>;
+    list(scope: OwnerScope, includeGlobal?: boolean): Promise<Array<PersistedFilterState & {
+        scope: OwnerScope;
+    }>>;
+}
+export declare class MemorySessionObjectStore implements SessionObjectStore {
+    private store;
+    private aliases;
+    getAlias(sessionId: string, alias: string): Promise<string | null>;
+    setAlias(sessionId: string, alias: string, targetId: string): Promise<void>;
+    deleteAlias(sessionId: string, alias: string): Promise<void>;
+    listAliases(sessionId: string): Promise<Array<{
+        alias: string;
+        targetId: string;
+    }>>;
+    create(sessionId: string, state: Omit<ObjectState, "objectId"> & {
+        objectId?: string;
+    }, alias?: string): Promise<string>;
+    get(sessionId: string, id: string): Promise<ObjectState | null>;
+    set(sessionId: string, id: string, state: ObjectState): Promise<void>;
+    delete(sessionId: string, id: string): Promise<void>;
+    listSession(sessionId: string): Promise<string[]>;
+    listChildren(sessionId: string, parentId: string): Promise<string[]>;
+    expireSession(sessionId: string, olderThanMs?: number): Promise<void>;
+}
+export declare class MemoryPersistentObjectStore implements PersistentObjectStore {
+    private store;
+    private getScopeKey;
+    get(id: string, scope: OwnerScope): Promise<PersistedObjectState | null>;
+    set(id: string, state: PersistedObjectState, scope: OwnerScope): Promise<void>;
+    delete(id: string, scope: OwnerScope): Promise<void>;
+    findByTag(tag: string, scope: OwnerScope): Promise<PersistedObjectState[]>;
+    list(scope: OwnerScope, includeGlobal?: boolean): Promise<Array<PersistedObjectState & {
+        scope: OwnerScope;
+    }>>;
+}
+export declare class MemorySessionEventStore implements SessionEventStore {
+    private store;
+    private aliases;
+    getAlias(sessionId: string, alias: string): Promise<string | null>;
+    setAlias(sessionId: string, alias: string, targetId: string): Promise<void>;
+    deleteAlias(sessionId: string, alias: string): Promise<void>;
+    listAliases(sessionId: string): Promise<Array<{
+        alias: string;
+        targetId: string;
+    }>>;
+    get(sessionId: string, commitId: string): Promise<EventCommit | null>;
+    set(sessionId: string, commitId: string, state: EventCommit): Promise<void>;
+    delete(sessionId: string, commitId: string): Promise<void>;
+    listSession(sessionId: string): Promise<string[]>;
+    listChildren(sessionId: string, parentId: string): Promise<string[]>;
+    expireSession(sessionId: string, olderThanMs?: number): Promise<void>;
+    create(sessionId: string, state: Omit<EventCommit, "commitId"> & {
+        commitId?: string;
+    }, alias?: string): Promise<string>;
+}
+export declare class MemoryPersistentEventStore implements PersistentEventStore {
+    private store;
+    get(commitId: string, scope: OwnerScope): Promise<PersistedEventState | null>;
+    set(commitId: string, state: PersistedEventState, scope: OwnerScope): Promise<void>;
+    delete(commitId: string, scope: OwnerScope): Promise<void>;
+    findByTag(tag: string, scope: OwnerScope): Promise<PersistedEventState[]>;
+    list(scope: OwnerScope, includeGlobal?: boolean): Promise<Array<PersistedEventState & {
+        scope: OwnerScope;
+    }>>;
+}
+export declare class MemorySessionFormStore implements SessionFormStore {
+    private store;
+    private aliases;
+    getAlias(sessionId: string, alias: string): Promise<string | null>;
+    setAlias(sessionId: string, alias: string, targetId: string): Promise<void>;
+    deleteAlias(sessionId: string, alias: string): Promise<void>;
+    listAliases(sessionId: string): Promise<Array<{
+        alias: string;
+        targetId: string;
+    }>>;
+    create(sessionId: string, state: Omit<FormState, "formId"> & {
+        formId?: string;
+    }, alias?: string): Promise<string>;
+    get(sessionId: string, id: string): Promise<FormState | null>;
+    set(sessionId: string, id: string, state: FormState): Promise<void>;
+    delete(sessionId: string, id: string): Promise<void>;
+    listSession(sessionId: string): Promise<string[]>;
+    listChildren(sessionId: string, parentId: string): Promise<string[]>;
+    expireSession(sessionId: string, olderThanMs?: number): Promise<void>;
+}
+export declare class MemoryPersistentFormStore implements PersistentFormStore {
+    private store;
+    get(id: string, scope: OwnerScope): Promise<PersistedFormStateDetails | null>;
+    set(id: string, state: PersistedFormStateDetails, scope: OwnerScope): Promise<void>;
+    delete(id: string, scope: OwnerScope): Promise<void>;
+    findByTag(tag: string, scope: OwnerScope): Promise<PersistedFormStateDetails[]>;
+    list(scope: OwnerScope, includeGlobal?: boolean): Promise<Array<PersistedFormStateDetails & {
+        scope: OwnerScope;
+    }>>;
+}
+//# sourceMappingURL=memory-repo.d.ts.map

package/dist/src/adapters/storage/memory-repo.d.ts.map

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

package/dist/src/adapters/storage/pg-repo.d.ts

@@ -0,0 +1,38 @@
+import type { OwnerScope } from "../../config/types";
+import type { FilterState } from "../../middleware/filter/types";
+import type { SessionFilterStore, PersistentFilterStore, PersistedFilterState } from "./interfaces";
+export declare class PgFilterStore implements SessionFilterStore, PersistentFilterStore {
+    private pool;
+    constructor(connectionString: string);
+    private initSchema;
+    get(sessionId: string, id: string): Promise<FilterState | null>;
+    get(id: string, scope: OwnerScope): Promise<PersistedFilterState | null>;
+    set(sessionId: string, id: string, state: FilterState): Promise<void>;
+    set(id: string, state: PersistedFilterState, scope: OwnerScope): Promise<void>;
+    delete(sessionId: string, id: string): Promise<void>;
+    delete(id: string, scope: OwnerScope): Promise<void>;
+    getAlias(sessionId: string, alias: string): Promise<string | null>;
+    setAlias(sessionId: string, alias: string, targetId: string): Promise<void>;
+    deleteAlias(sessionId: string, alias: string): Promise<void>;
+    listAliases(sessionId: string): Promise<Array<{
+        alias: string;
+        targetId: string;
+    }>>;
+    create(sessionId: string, state: Omit<FilterState, "filterId"> & {
+        filterId?: string;
+    }, alias?: string): Promise<string>;
+    private getSession;
+    private setSession;
+    private deleteSession;
+    private getPersistent;
+    private setPersistent;
+    private deletePersistent;
+    listSession(sessionId: string): Promise<string[]>;
+    listChildren(sessionId: string, parentId: string): Promise<string[]>;
+    expireSession(sessionId: string, olderThanMs?: number): Promise<void>;
+    findByTag(tag: string, scope: OwnerScope): Promise<PersistedFilterState[]>;
+    list(scope: OwnerScope, includeGlobal?: boolean): Promise<Array<PersistedFilterState & {
+        scope: OwnerScope;
+    }>>;
+}
+//# sourceMappingURL=pg-repo.d.ts.map

package/dist/src/adapters/storage/pg-repo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pg-repo.d.ts","sourceRoot":"","sources":["../../../../src/adapters/storage/pg-repo.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAmB,MAAM,+BAA+B,CAAC;AAClF,OAAO,KAAK,EACV,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,cAAc,CAAC;AAItB,qBAAa,aAAc,YAAW,kBAAkB,EAAE,qBAAqB;IAC7E,OAAO,CAAC,IAAI,CAAO;gBAEP,gBAAgB,EAAE,MAAM;YAKtB,UAAU;IAmExB,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAC/D,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAWxE,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IACrE,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,oBAAoB,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAW9E,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACpD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAS9C,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAQlE,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS3E,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5D,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAQnF,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,GAAG;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAYhH,UAAU;YAgCV,UAAU;YA6CV,aAAa;YAiBb,aAAa;YA2Cb,aAAa;YA0Db,gBAAgB;IAkBxB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAQjD,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAQpE,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BrE,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAkB1E,IAAI,CACR,KAAK,EAAE,UAAU,EACjB,aAAa,CAAC,EAAE,OAAO,GACtB,OAAO,CAAC,KAAK,CAAC,oBAAoB,GAAG;QAAE,KAAK,EAAE,UAAU,CAAA;KAAE,CAAC,CAAC;CA4BhE"}

package/dist/src/adapters/storage/sqlite-repo.d.ts

@@ -0,0 +1,91 @@
+import type { OwnerScope } from "../../config/types";
+import type { FilterState } from "../../middleware/filter/types";
+import type { SessionFilterStore, PersistentFilterStore, PersistedFilterState, SessionFormStore, PersistentFormStore, PersistedFormStateDetails } from "./interfaces";
+import type { FormState } from "../../middleware/form/types";
+import type { ConceptStore, PersistentExpressionStore } from "../../middleware/dictionary/interfaces";
+import type { Concept, Namespace, CustomExpression } from "../../middleware/dictionary/types";
+export declare class SqliteFilterStore implements SessionFilterStore, PersistentFilterStore {
+    private db;
+    constructor(dbPath: string);
+    private initSchema;
+    get(sessionId: string, id: string): Promise<FilterState | null>;
+    get(id: string, scope: OwnerScope): Promise<PersistedFilterState | null>;
+    set(sessionId: string, id: string, state: FilterState): Promise<void>;
+    set(id: string, state: PersistedFilterState, scope: OwnerScope): Promise<void>;
+    delete(sessionId: string, id: string): Promise<void>;
+    delete(id: string, scope: OwnerScope): Promise<void>;
+    getAlias(sessionId: string, alias: string): Promise<string | null>;
+    setAlias(sessionId: string, alias: string, targetId: string): Promise<void>;
+    deleteAlias(sessionId: string, alias: string): Promise<void>;
+    listAliases(sessionId: string): Promise<Array<{
+        alias: string;
+        targetId: string;
+    }>>;
+    create(sessionId: string, state: Omit<FilterState, "filterId"> & {
+        filterId?: string;
+    }, alias?: string): Promise<string>;
+    private getSession;
+    private setSession;
+    private deleteSession;
+    private getPersistent;
+    private setPersistent;
+    private deletePersistent;
+    listSession(sessionId: string): Promise<string[]>;
+    listChildren(sessionId: string, parentId: string): Promise<string[]>;
+    expireSession(sessionId: string, olderThanMs?: number): Promise<void>;
+    findByTag(tag: string, scope: OwnerScope): Promise<PersistedFilterState[]>;
+    list(scope: OwnerScope, includeGlobal?: boolean): Promise<Array<PersistedFilterState & {
+        scope: OwnerScope;
+    }>>;
+}
+export declare class SqliteFormStore implements SessionFormStore, PersistentFormStore {
+    private db;
+    constructor(dbPath: string);
+    private initSchema;
+    get(sessionId: string, id: string): Promise<FormState | null>;
+    get(id: string, scope: OwnerScope): Promise<PersistedFormStateDetails | null>;
+    private getSession;
+    private getPersistent;
+    private loadState;
+    set(sessionId: string, id: string, state: FormState): Promise<void>;
+    set(id: string, state: PersistedFormStateDetails, scope: OwnerScope): Promise<void>;
+    private setSession;
+    private setPersistent;
+    delete(sessionId: string, id: string): Promise<void>;
+    delete(id: string, scope: OwnerScope): Promise<void>;
+    listSession(sessionId: string): Promise<string[]>;
+    listChildren(sessionId: string, parentId: string): Promise<string[]>;
+    expireSession(sessionId: string, olderThanMs?: number): Promise<void>;
+    create(sessionId: string, state: Omit<FormState, "formId"> & {
+        formId?: string;
+    }, alias?: string): Promise<string>;
+    getAlias(sessionId: string, alias: string): Promise<string | null>;
+    setAlias(sessionId: string, alias: string, targetId: string): Promise<void>;
+    deleteAlias(sessionId: string, alias: string): Promise<void>;
+    listAliases(sessionId: string): Promise<Array<{
+        alias: string;
+        targetId: string;
+    }>>;
+    findByTag(tag: string, scope: OwnerScope): Promise<PersistedFormStateDetails[]>;
+    list(scope: OwnerScope, includeGlobal?: boolean): Promise<Array<PersistedFormStateDetails & {
+        scope: OwnerScope;
+    }>>;
+}
+export declare class SqliteConceptStore implements ConceptStore {
+    private db;
+    constructor(dbPath: string);
+    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 SqlitePersistentExpressionStore implements PersistentExpressionStore {
+    private db;
+    constructor(dbPath: string);
+    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>;
+}
+//# sourceMappingURL=sqlite-repo.d.ts.map

package/dist/src/adapters/storage/sqlite-repo.d.ts.map

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

package/dist/src/adapters/validation/references.d.ts

@@ -0,0 +1,6 @@
+export declare function validateStateReferences(schema: any, data: any, sessionId: string, stores: {
+    filter?: any;
+    object?: any;
+    form?: any;
+}): Promise<void>;
+//# sourceMappingURL=references.d.ts.map

package/dist/src/adapters/validation/references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../../../../src/adapters/validation/references.ts"],"names":[],"mappings":"AAAA,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,GAAG,EACX,IAAI,EAAE,GAAG,EACT,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE;IACN,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ,GACA,OAAO,CAAC,IAAI,CAAC,CA0Cf"}

package/dist/src/adapters/validation/runner.d.ts

@@ -0,0 +1,28 @@
+import type { ResourceLocator } from "../../config/types";
+export interface ExternalValidationResult {
+    valid: boolean;
+    errors?: string[];
+}
+/**
+ * Resolves and executes a validation_engine against a given payload.
+ * Supports:
+ *   - _type: "file"       — loads JSON Schema and validates with AJV
+ *   - _type: "remote_url" — POSTs JSON payload to a remote API endpoint
+ *
+ * Expected remote API response format:
+ *   { "valid": true }
+ *   { "valid": false, "errors": ["reason 1", ...] }
+ *
+ * POST body format:
+ *   {
+ *     "serviceType": "object" | "event",
+ *     "schemaName": string,
+ *     "data": any      // full object or full event array
+ *   }
+ */
+export declare function runValidationEngine(locator: ResourceLocator, payload: {
+    serviceType: "object" | "event";
+    schemaName: string;
+    data: any;
+}, workspaceRoot: string): Promise<ExternalValidationResult>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/src/adapters/validation/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../../src/adapters/validation/runner.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAO1D,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE;IAAE,WAAW,EAAE,QAAQ,GAAG,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,GAAG,CAAA;CAAE,EAC3E,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,wBAAwB,CAAC,CA+CnC"}

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

@@ -0,0 +1,33 @@
+import type { ResourceLocator, MiddlewareConfig } from "./types";
+export declare function loadEnvSources(sources: Array<{
+    _type: string;
+    path?: string;
+    optional?: boolean;
+}>): Promise<void>;
+export declare function substituteEnvVars(obj: unknown): unknown;
+export declare function replacePlaceholders(str: string, context?: Record<string, string>): string;
+export declare function resolveSource(locator: ResourceLocator, workspaceRoot: string, context?: Record<string, string>): Promise<unknown>;
+export interface AdapterFactory<T> {
+    create(options: Record<string, unknown>): Promise<T>;
+}
+export declare function registerAdapter<T>(name: string, factory: AdapterFactory<T>): void;
+export declare function resolveAdapter<T>(name: string, options?: Record<string, unknown>, workspaceRoot?: string): Promise<T>;
+export declare function clearCache(): void;
+/**
+ * Resolves the directory that holds the `config/` folder.
+ *
+ * Search order (explicit overrides implicit):
+ *   1. `--config-dir <path>` / `-c <path>` / `--config-dir=<path>` CLI flag
+ *   2. `STATEFUL_MCP_CONFIG_DIR` environment variable
+ *   3. `process.cwd()` (fallback, preserved for self-hosting convenience)
+ */
+export declare function resolveConfigDir(argv?: string[]): string;
+/**
+ * Loads the middleware configuration by reading and merging tools and storage configs.
+ * The config directory is resolved explicitly (see `resolveConfigDir`) so consumers
+ * can point the package at their own config rather than relying on cwd.
+ */
+export declare function loadMiddlewareConfig(workspaceRoot?: string): Promise<MiddlewareConfig>;
+export declare function resolveTextSource(locator: ResourceLocator, workspaceRoot: string, context?: Record<string, string>): Promise<string>;
+export declare function resolveAboutOrExamples(locators: ResourceLocator[] | undefined, fallbackPath: string, workspaceRoot: string, context?: Record<string, string>): Promise<string>;
+//# sourceMappingURL=loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/config/loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAIjE,wBAAsB,cAAc,CAClC,OAAO,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,GACnE,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAevD;AAID,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAMzF;AAKD,wBAAsB,aAAa,CACjC,OAAO,EAAE,eAAe,EACxB,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,OAAO,CAAC,CA2ClB;AAID,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACtD;AAID,wBAAgB,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI,CAGjF;AAED,wBAAsB,cAAc,CAAC,CAAC,EACpC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACrC,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,CAAC,CAAC,CA4BZ;AAED,wBAAgB,UAAU,IAAI,IAAI,CAEjC;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,MAAM,CAgB/E;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAgD5F;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,eAAe,EACxB,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,MAAM,CAAC,CAgBjB;AAED,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,eAAe,EAAE,GAAG,SAAS,EACvC,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,MAAM,CAAC,CAoBjB"}

package/dist/src/config/loader.js

@@ -0,0 +1,232 @@
+// @bun
+// src/config/loader.ts
+import * as fs from "fs/promises";
+import * as path from "path";
+async function loadEnvSources(sources) {
+  for (const src of sources) {
+    if (src._type !== "file" || !src.path)
+      continue;
+    try {
+      const raw = await fs.readFile(src.path, "utf-8");
+      for (const line of raw.split(`
+`)) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#"))
+          continue;
+        const eq = trimmed.indexOf("=");
+        if (eq === -1)
+          continue;
+        const key = trimmed.slice(0, eq).trim();
+        const val = trimmed.slice(eq + 1).trim();
+        if (!(key in process.env))
+          process.env[key] = val;
+      }
+    } catch (err) {
+      if (!src.optional)
+        throw new Error(`Required env file not found: ${src.path}`);
+    }
+  }
+}
+function substituteEnvVars(obj) {
+  if (typeof obj === "string" && obj.startsWith("env:")) {
+    const key = obj.slice(4);
+    const val = process.env[key];
+    if (val === undefined)
+      throw new Error(`Missing env variable: ${key}`);
+    return val;
+  }
+  if (Array.isArray(obj))
+    return obj.map(substituteEnvVars);
+  if (obj && typeof obj === "object") {
+    return Object.fromEntries(Object.entries(obj).map(([k, v]) => [k, substituteEnvVars(v)]));
+  }
+  return obj;
+}
+function replacePlaceholders(str, context) {
+  if (!context)
+    return str;
+  return str.replace(/\{([^}]+)\}/g, (match, key) => {
+    const val = context[key];
+    return val !== undefined ? encodeURIComponent(val) : match;
+  });
+}
+var sourceCache = new Map;
+async function resolveSource(locator, workspaceRoot, context) {
+  const cacheKey = JSON.stringify(locator) + (context ? `:${JSON.stringify(context)}` : "");
+  const ttl = locator._type !== "adapter" ? locator.ttl_ms ?? 0 : 0;
+  if (ttl === 0) {
+    const cached = sourceCache.get(cacheKey);
+    if (cached)
+      return cached.value;
+  } else {
+    const cached = sourceCache.get(cacheKey);
+    if (cached && Date.now() - cached.resolvedAt < ttl)
+      return cached.value;
+  }
+  let value;
+  switch (locator._type) {
+    case "adapter":
+      return resolveAdapter(locator.name, substituteEnvVars(locator.options ?? {}), workspaceRoot);
+    case "file": {
+      const finalPath = replacePlaceholders(locator.path, context);
+      const resolved = path.resolve(workspaceRoot, finalPath);
+      const raw = await fs.readFile(resolved, "utf-8");
+      value = substituteEnvVars(JSON.parse(raw));
+      break;
+    }
+    case "remote_url": {
+      const url = replacePlaceholders(locator.url, context);
+      const res = await fetch(url, { headers: locator.headers });
+      if (!res.ok)
+        throw new Error(`resolveSource fetch failed: ${url} \u2192 HTTP ${res.status}`);
+      value = substituteEnvVars(await res.json());
+      break;
+    }
+    default:
+      throw new Error(`Unknown ResourceLocator _type: ${locator._type}`);
+  }
+  sourceCache.set(cacheKey, { value, resolvedAt: Date.now() });
+  return value;
+}
+var registry = new Map;
+function registerAdapter(name, factory) {
+  if (registry.has(name))
+    throw new Error(`Adapter already registered: "${name}"`);
+  registry.set(name, factory);
+}
+async function resolveAdapter(name, options = {}, workspaceRoot) {
+  if (name.startsWith("@")) {
+    if (!workspaceRoot)
+      throw new Error(`Cannot resolve path alias "${name}" without workspaceRoot`);
+    const rawPath = name.slice(1);
+    let absolutePath;
+    if (rawPath.startsWith("/")) {
+      absolutePath = rawPath;
+    } else if (rawPath.startsWith("~/")) {
+      const home = process.env["HOME"] || process.env["USERPROFILE"] || "";
+      absolutePath = path.join(home, rawPath.slice(2));
+    } else {
+      absolutePath = path.resolve(workspaceRoot, rawPath);
+    }
+    await import(absolutePath);
+  }
+  const factory = registry.get(name);
+  if (!factory)
+    throw new Error(`Unregistered adapter: "${name}". Did the module call registerAdapter()?`);
+  return factory.create(options);
+}
+function clearCache() {
+  sourceCache.clear();
+}
+function resolveConfigDir(argv = process.argv.slice(2)) {
+  for (let i = 0;i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === undefined)
+      continue;
+    if (arg === "--config-dir" || arg === "-c") {
+      const next = argv[i + 1];
+      if (next !== undefined)
+        return next;
+    }
+    if (arg.startsWith("--config-dir=")) {
+      return arg.slice("--config-dir=".length);
+    }
+  }
+  if (process.env.STATEFUL_MCP_CONFIG_DIR) {
+    return process.env.STATEFUL_MCP_CONFIG_DIR;
+  }
+  return process.cwd();
+}
+async function loadMiddlewareConfig(workspaceRoot) {
+  const resolvedRoot = workspaceRoot ?? resolveConfigDir();
+  const toolsPath = path.join(resolvedRoot, "config", "tools.config.json");
+  const storagePath = path.join(resolvedRoot, "config", "storage.config.json");
+  const aboutPath = path.join(resolvedRoot, "config", "about.config.json");
+  let toolsConfig = {};
+  let storageConfig = {};
+  let aboutConfig = {};
+  try {
+    const rawTools = await fs.readFile(toolsPath, "utf-8");
+    toolsConfig = JSON.parse(rawTools);
+  } catch (e) {
+    const mainPath = path.join(resolvedRoot, "filter.config.json");
+    try {
+      const rawMain = await fs.readFile(mainPath, "utf-8");
+      const parsedMain = JSON.parse(rawMain);
+      return substituteEnvVars(parsedMain);
+    } catch (e2) {
+      throw new Error(`Failed to find or parse configuration file in ${resolvedRoot}`);
+    }
+  }
+  try {
+    const rawStorage = await fs.readFile(storagePath, "utf-8");
+    storageConfig = JSON.parse(rawStorage);
+  } catch (e) {
+    throw new Error(`Storage configuration not found at ${storagePath}`);
+  }
+  try {
+    const rawAbout = await fs.readFile(aboutPath, "utf-8");
+    aboutConfig = JSON.parse(rawAbout);
+  } catch (e) {}
+  const merged = {
+    ...storageConfig,
+    ...aboutConfig,
+    tools: toolsConfig.tools || toolsConfig
+  };
+  return substituteEnvVars(merged);
+}
+async function resolveTextSource(locator, workspaceRoot, context) {
+  switch (locator._type) {
+    case "file": {
+      const finalPath = replacePlaceholders(locator.path, context);
+      const resolved = path.resolve(workspaceRoot, finalPath);
+      return await fs.readFile(resolved, "utf-8");
+    }
+    case "remote_url": {
+      const url = replacePlaceholders(locator.url, context);
+      const res = await fetch(url, { headers: locator.headers });
+      if (!res.ok)
+        throw new Error(`resolveTextSource fetch failed: ${url} \u2192 HTTP ${res.status}`);
+      return await res.text();
+    }
+    default:
+      throw new Error(`resolveTextSource only supports file and remote_url locators for raw text reading`);
+  }
+}
+async function resolveAboutOrExamples(locators, fallbackPath, workspaceRoot, context) {
+  if (!locators || locators.length === 0) {
+    try {
+      const defaultResolved = path.resolve(workspaceRoot, fallbackPath);
+      return await fs.readFile(defaultResolved, "utf-8");
+    } catch (_) {
+      return "";
+    }
+  }
+  const results = [];
+  for (const loc of locators) {
+    try {
+      const content = await resolveTextSource(loc, workspaceRoot, context);
+      results.push(content);
+    } catch (err) {
+      results.push(`[Error loading resource: ${err.message}]`);
+    }
+  }
+  return results.join(`
+
+---
+
+`);
+}
+export {
+  substituteEnvVars,
+  resolveTextSource,
+  resolveSource,
+  resolveConfigDir,
+  resolveAdapter,
+  resolveAboutOrExamples,
+  replacePlaceholders,
+  registerAdapter,
+  loadMiddlewareConfig,
+  loadEnvSources,
+  clearCache
+};

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

@@ -0,0 +1,44 @@
+import { z } from "zod";
+import type { PaginationLimitsConfig } from "./types";
+declare const SURFACES: {
+    readonly log_page_size: {
+        readonly default: 20;
+        readonly ceiling: 200;
+    };
+    readonly examples_page_size: {
+        readonly default: 5;
+        readonly ceiling: 50;
+    };
+    readonly merge_conflicts_page_size: {
+        readonly default: 50;
+        readonly ceiling: 500;
+    };
+};
+export type LimitKey = keyof typeof SURFACES;
+/**
+ * Clamp a caller-supplied limit to [1, ceiling].
+ *
+ * Resolution order:
+ *   1. Start with the caller-requested value (if any).
+ *   2. Fall back to the operator-configured default (pagination_limits field).
+ *   3. Fall back to the built-in default.
+ *   4. Never exceed the hard ceiling regardless of config or caller.
+ */
+export declare function clampLimit(requested: number | undefined, key: LimitKey, cfg: PaginationLimitsConfig | undefined): number;
+/**
+ * Returns the effective maximum to advertise in a Zod schema (.max() / JSON Schema "maximum").
+ * This is the operator-configured default capped at the hard ceiling — i.e. the largest value
+ * a caller may request on this surface given the current configuration.
+ */
+export declare function getMax(key: LimitKey, cfg: PaginationLimitsConfig | undefined): number;
+/**
+ * Builds a Zod field for a caller-supplied `limit`, advertising the
+ * operator-configured maximum as a JSON-Schema-style bound (min/max) the way
+ * OpenAI function schemas do. The bounds are derived entirely from config at
+ * registration time — the default/ceiling numbers are never hardcoded into a
+ * description string, so changing `pagination_limits` in config is reflected
+ * automatically without touching service code.
+ */
+export declare function buildLimitField(key: LimitKey, cfg: PaginationLimitsConfig | undefined): z.ZodOptional<z.ZodNumber>;
+export {};
+//# sourceMappingURL=pagination.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../../src/config/pagination.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAGtD,QAAA,MAAM,QAAQ;;;;;;;;;;;;;CAIJ,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,QAAQ,CAAC;AAE7C;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,GAAG,EAAE,QAAQ,EACb,GAAG,EAAE,sBAAsB,GAAG,SAAS,GACtC,MAAM,CASR;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,sBAAsB,GAAG,SAAS,GAAG,MAAM,CAErF;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,sBAAsB,GAAG,SAAS,8BAWrF"}