@thoughtflow/core 0.1.2

package/dist/libs/message-history.class.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MessageHistory = void 0;
+const payload_offload_manager_1 = require("./payload-offload.manager");
+class MessageHistory {
+    messages = [];
+    offloadManager;
+    constructor(cacheDir, offloadThreshold) {
+        this.offloadManager = new payload_offload_manager_1.PayloadOffloadManager(cacheDir, offloadThreshold);
+    }
+    push(role, content, metadata) {
+        const message = {
+            id: this.generateId(role),
+            role,
+            content,
+            createdAt: new Date().toISOString(),
+            metadata
+        };
+        this.messages.push(message);
+        return message;
+    }
+    /** Insert at the beginning (position 0) — used for system messages that must come first for vLLM. */
+    unshift(role, content, metadata) {
+        const message = {
+            id: this.generateId(role),
+            role,
+            content,
+            createdAt: new Date().toISOString(),
+            metadata
+        };
+        this.messages.unshift(message);
+        return message;
+    }
+    pushAssistant(content, toolCalls, reasoningContent) {
+        const message = {
+            id: this.generateId("assistant"),
+            role: "assistant",
+            content,
+            createdAt: new Date().toISOString(),
+            toolCalls,
+            reasoningContent,
+        };
+        this.messages.push(message);
+        return message;
+    }
+    pushToolResult(toolName, content, toolCallId) {
+        const { content: processedContent, metadata: offloadMetadata } = this.offloadManager.processContent(content, { toolName });
+        const message = {
+            id: this.generateId("tool"),
+            role: "tool",
+            content: processedContent,
+            createdAt: new Date().toISOString(),
+            toolCallId,
+            metadata: offloadMetadata
+        };
+        this.messages.push(message);
+        return message;
+    }
+    snapshot() {
+        return this.messages.map((message) => this.cloneMessage(message));
+    }
+    /**
+     * Get snapshot with offloaded payloads resolved to full content
+     */
+    snapshotWithResolvedPayloads() {
+        return this.messages.map((message) => {
+            const cloned = this.cloneMessage(message);
+            if (cloned.metadata?.payloadOffload) {
+                cloned.content = this.offloadManager.resolveContent(cloned.content, cloned.metadata);
+            }
+            return cloned;
+        });
+    }
+    replace(messages) {
+        this.messages.length = 0;
+        this.messages.push(...messages.map((message) => this.cloneMessage(message)));
+    }
+    clear() {
+        this.messages.length = 0;
+        this.offloadManager.cleanupAll();
+    }
+    generateId(role) {
+        return `${role}_${Date.now()}_${Math.random().toString(36).slice(2, 10)}`;
+    }
+    cloneMessage(message) {
+        return {
+            ...message,
+            toolCalls: message.toolCalls?.map((call) => ({
+                id: call.id,
+                name: call.name,
+                arguments: { ...(call.arguments ?? {}) }
+            })),
+            metadata: message.metadata ? { ...message.metadata } : undefined
+        };
+    }
+}
+exports.MessageHistory = MessageHistory;
+//# sourceMappingURL=message-history.class.js.map

package/dist/libs/message-history.class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-history.class.js","sourceRoot":"","sources":["../../src/libs/message-history.class.ts"],"names":[],"mappings":"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"}

package/dist/libs/message-utils.d.ts

@@ -0,0 +1,6 @@
+import type { ContentPart, ConversationMessage, ImageContent } from "../contracts";
+export declare function textContentPart(text: string): ContentPart;
+export declare function imageContentPart(base64Data: string, detail?: "low" | "high" | "auto"): ImageContent;
+export declare function buildUserVisionMessage(text: string, imageBase64: string, id?: string): ConversationMessage;
+export declare function extractBase64FromScreenshot(output: string): string | null;
+//# sourceMappingURL=message-utils.d.ts.map

package/dist/libs/message-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-utils.d.ts","sourceRoot":"","sources":["../../src/libs/message-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAInF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAEzD;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,YAAY,CASnG;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,EAAE,CAAC,EAAE,MAAM,GACV,mBAAmB,CAQrB;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMzE"}

package/dist/libs/message-utils.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.textContentPart = textContentPart;
+exports.imageContentPart = imageContentPart;
+exports.buildUserVisionMessage = buildUserVisionMessage;
+exports.extractBase64FromScreenshot = extractBase64FromScreenshot;
+let messageCounter = 0;
+function textContentPart(text) {
+    return { type: "text", text };
+}
+function imageContentPart(base64Data, detail) {
+    const prefix = base64Data.startsWith("data:") ? "" : "data:image/png;base64,";
+    return {
+        type: "image_url",
+        image_url: {
+            url: `${prefix}${base64Data}`,
+            ...(detail ? { detail } : {}),
+        },
+    };
+}
+function buildUserVisionMessage(text, imageBase64, id) {
+    return {
+        id: id ?? `msg_vision_${++messageCounter}_${Date.now()}`,
+        role: "user",
+        content: text,
+        contentParts: [textContentPart(text), imageContentPart(imageBase64)],
+        createdAt: new Date().toISOString(),
+    };
+}
+function extractBase64FromScreenshot(output) {
+    const prefix = "screenshot:base64:";
+    if (output.startsWith(prefix)) {
+        return output.slice(prefix.length);
+    }
+    return null;
+}
+//# sourceMappingURL=message-utils.js.map

package/dist/libs/message-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-utils.js","sourceRoot":"","sources":["../../src/libs/message-utils.ts"],"names":[],"mappings":";;AAIA,0CAEC;AAED,4CASC;AAED,wDAYC;AAED,kEAMC;AArCD,IAAI,cAAc,GAAG,CAAC,CAAC;AAEvB,SAAgB,eAAe,CAAC,IAAY;IAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAChC,CAAC;AAED,SAAgB,gBAAgB,CAAC,UAAkB,EAAE,MAAgC;IACnF,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,wBAAwB,CAAC;IAC9E,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,SAAS,EAAE;YACT,GAAG,EAAE,GAAG,MAAM,GAAG,UAAU,EAAE;YAC7B,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9B;KACF,CAAC;AACJ,CAAC;AAED,SAAgB,sBAAsB,CACpC,IAAY,EACZ,WAAmB,EACnB,EAAW;IAEX,OAAO;QACL,EAAE,EAAE,EAAE,IAAI,cAAc,EAAE,cAAc,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE;QACxD,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,IAAI;QACb,YAAY,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC,WAAW,CAAC,CAAC;QACpE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,SAAgB,2BAA2B,CAAC,MAAc;IACxD,MAAM,MAAM,GAAG,oBAAoB,CAAC;IACpC,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/libs/model-ref-resolver.d.ts

@@ -0,0 +1,25 @@
+import { LlmAdapter, ModelRef } from "../contracts/llm.types";
+/**
+ * Resolves a {@link ModelRef} (or string shorthand) into a concrete
+ * `{ adapter, model }` pair, using parent fallback values for any
+ * omitted fields.
+ */
+export declare class ModelRefResolver {
+    /**
+     * Resolve a ModelRef (or plain model name string) into a concrete
+     * adapter + model pair.  Falls back to parent adapter/model for
+     * any fields omitted from the ModelRef.
+     *
+     * @param ref      ModelRef, plain string, or undefined (use all fallbacks)
+     * @param fallback Parent adapter and model name to inherit from
+     */
+    resolve(ref: string | ModelRef | undefined, fallback: {
+        adapter: LlmAdapter;
+        model: string;
+    }): {
+        adapter: LlmAdapter;
+        model: string;
+    };
+    private buildAdapter;
+}
+//# sourceMappingURL=model-ref-resolver.d.ts.map

package/dist/libs/model-ref-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-ref-resolver.d.ts","sourceRoot":"","sources":["../../src/libs/model-ref-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAG7D;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B;;;;;;;OAOG;IACH,OAAO,CACL,GAAG,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,EAClC,QAAQ,EAAE;QAAE,OAAO,EAAE,UAAU,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAC/C;QAAE,OAAO,EAAE,UAAU,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;IAiBzC,OAAO,CAAC,YAAY;CAyBrB"}

package/dist/libs/model-ref-resolver.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModelRefResolver = void 0;
+const adapter_factory_1 = require("../adapters/llm/adapter-factory");
+/**
+ * Resolves a {@link ModelRef} (or string shorthand) into a concrete
+ * `{ adapter, model }` pair, using parent fallback values for any
+ * omitted fields.
+ */
+class ModelRefResolver {
+    /**
+     * Resolve a ModelRef (or plain model name string) into a concrete
+     * adapter + model pair.  Falls back to parent adapter/model for
+     * any fields omitted from the ModelRef.
+     *
+     * @param ref      ModelRef, plain string, or undefined (use all fallbacks)
+     * @param fallback Parent adapter and model name to inherit from
+     */
+    resolve(ref, fallback) {
+        if (ref === undefined) {
+            return fallback;
+        }
+        if (typeof ref === "string") {
+            return { adapter: fallback.adapter, model: ref };
+        }
+        const model = ref.model ?? fallback.model;
+        const adapter = ref.connection
+            ? this.buildAdapter(ref)
+            : fallback.adapter;
+        return { adapter, model };
+    }
+    buildAdapter(ref) {
+        const provider = ref.provider ?? "ollama";
+        const connection = ref.connection;
+        switch (provider) {
+            case "ollama": {
+                const baseUrl = connection.baseUrl
+                    ?? `http://${connection.host ?? "localhost"}:${connection.port ?? 11434}`;
+                return adapter_factory_1.LlmAdapterFactory.create({ type: "ollama", baseUrl });
+            }
+            case "openai":
+                return adapter_factory_1.LlmAdapterFactory.create({
+                    type: "openai",
+                    apiKey: connection.apiKey ?? "",
+                    baseUrl: connection.baseUrl
+                });
+            case "anthropic":
+                return adapter_factory_1.LlmAdapterFactory.create({
+                    type: "anthropic",
+                    apiKey: connection.apiKey ?? ""
+                });
+            case "mock":
+                return adapter_factory_1.LlmAdapterFactory.create({ type: "mock" });
+        }
+    }
+}
+exports.ModelRefResolver = ModelRefResolver;
+//# sourceMappingURL=model-ref-resolver.js.map

package/dist/libs/model-ref-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-ref-resolver.js","sourceRoot":"","sources":["../../src/libs/model-ref-resolver.ts"],"names":[],"mappings":";;;AACA,qEAAmE;AAEnE;;;;GAIG;AACH,MAAa,gBAAgB;IAC3B;;;;;;;OAOG;IACH,OAAO,CACL,GAAkC,EAClC,QAAgD;QAEhD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,OAAO,QAAQ,CAAA;QACjB,CAAC;QAED,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAA;QAClD,CAAC;QAED,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,IAAI,QAAQ,CAAC,KAAK,CAAA;QACzC,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU;YAC5B,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC;YACxB,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAA;QAEpB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAA;IAC3B,CAAC;IAEO,YAAY,CAAC,GAAa;QAChC,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,IAAI,QAAQ,CAAA;QACzC,MAAM,UAAU,GAAG,GAAG,CAAC,UAAW,CAAA;QAElC,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO;uBAC7B,UAAU,UAAU,CAAC,IAAI,IAAI,WAAW,IAAI,UAAU,CAAC,IAAI,IAAI,KAAK,EAAE,CAAA;gBAC3E,OAAO,mCAAiB,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAA;YAC9D,CAAC;YACD,KAAK,QAAQ;gBACX,OAAO,mCAAiB,CAAC,MAAM,CAAC;oBAC9B,IAAI,EAAE,QAAQ;oBACd,MAAM,EAAE,UAAU,CAAC,MAAM,IAAI,EAAE;oBAC/B,OAAO,EAAE,UAAU,CAAC,OAAO;iBAC5B,CAAC,CAAA;YACJ,KAAK,WAAW;gBACd,OAAO,mCAAiB,CAAC,MAAM,CAAC;oBAC9B,IAAI,EAAE,WAAW;oBACjB,MAAM,EAAE,UAAU,CAAC,MAAM,IAAI,EAAE;iBAChC,CAAC,CAAA;YACJ,KAAK,MAAM;gBACT,OAAO,mCAAiB,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;QACrD,CAAC;IACH,CAAC;CACF;AAtDD,4CAsDC"}

package/dist/libs/multi-tenant.d.ts

@@ -0,0 +1,69 @@
+import EventEmitter from "events";
+export declare enum TenantStatus {
+    ACTIVE = "active",
+    SUSPENDED = "suspended",
+    DELETED = "deleted"
+}
+export interface ResourceQuota {
+    maxRequests: number;
+    maxStorage: number;
+    maxUsers: number;
+    maxApiKeys: number;
+}
+export interface TenantConfig {
+    id: string;
+    name: string;
+    status: TenantStatus;
+    quota: ResourceQuota;
+    customMetadata?: Record<string, any>;
+}
+export interface TenantContext {
+    tenantId: string;
+    userId: string;
+    permissions: string[];
+    requestId: string;
+}
+export interface ResourceUsage {
+    tenantId: string;
+    requests: number;
+    storage: number;
+    users: number;
+    apiKeys: number;
+}
+export declare class MultiTenantManager extends EventEmitter {
+    private tenants;
+    private resourceUsage;
+    private tenantData;
+    private contextStack;
+    constructor();
+    createTenant(config: TenantConfig): TenantConfig;
+    getTenant(tenantId: string): TenantConfig | undefined;
+    getAllTenants(): TenantConfig[];
+    updateTenant(tenantId: string, updates: Partial<TenantConfig>): void;
+    deleteTenant(tenantId: string): void;
+    suspendTenant(tenantId: string): void;
+    getQuota(tenantId: string): ResourceQuota | undefined;
+    updateQuota(tenantId: string, quota: ResourceQuota): void;
+    checkQuotaExceeded(tenantId: string): string[];
+    recordUsage(tenantId: string, metric: keyof ResourceUsage, amount?: number): void;
+    getResourceUsage(tenantId: string): ResourceUsage | undefined;
+    resetUsage(tenantId: string): void;
+    pushContext(context: TenantContext): void;
+    popContext(): TenantContext | undefined;
+    getCurrentContext(): TenantContext | undefined;
+    setContextPermissions(tenantId: string, permissions: string[]): void;
+    setTenantData(tenantId: string, key: string, value: any): void;
+    getTenantData(tenantId: string, key: string): any;
+    getTenantDataKeys(tenantId: string): string[];
+    deleteTenantData(tenantId: string, key: string): void;
+    clearTenantData(tenantId: string): void;
+    canAccessTenantData(context: TenantContext, targetTenantId: string): boolean;
+}
+export declare class MultiTenantBuilder {
+    private manager;
+    constructor();
+    addTenant(config: TenantConfig): MultiTenantBuilder;
+    build(): MultiTenantManager;
+    getManager(): MultiTenantManager;
+}
+//# sourceMappingURL=multi-tenant.d.ts.map

package/dist/libs/multi-tenant.d.ts.map

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

package/dist/libs/multi-tenant.js

@@ -0,0 +1,196 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MultiTenantBuilder = exports.MultiTenantManager = exports.TenantStatus = void 0;
+const events_1 = __importDefault(require("events"));
+var TenantStatus;
+(function (TenantStatus) {
+    TenantStatus["ACTIVE"] = "active";
+    TenantStatus["SUSPENDED"] = "suspended";
+    TenantStatus["DELETED"] = "deleted";
+})(TenantStatus || (exports.TenantStatus = TenantStatus = {}));
+class MultiTenantManager extends events_1.default {
+    tenants = new Map();
+    resourceUsage = new Map();
+    tenantData = new Map();
+    contextStack = [];
+    constructor() {
+        super();
+    }
+    // Tenant Management
+    createTenant(config) {
+        this.tenants.set(config.id, config);
+        this.resourceUsage.set(config.id, {
+            tenantId: config.id,
+            requests: 0,
+            storage: 0,
+            users: 0,
+            apiKeys: 0,
+        });
+        this.tenantData.set(config.id, new Map());
+        this.emit("tenant:created", { tenantId: config.id });
+        return config;
+    }
+    getTenant(tenantId) {
+        return this.tenants.get(tenantId);
+    }
+    getAllTenants() {
+        return Array.from(this.tenants.values());
+    }
+    updateTenant(tenantId, updates) {
+        const tenant = this.tenants.get(tenantId);
+        if (!tenant) {
+            throw new Error(`Tenant ${tenantId} not found`);
+        }
+        Object.assign(tenant, updates);
+        this.emit("tenant:updated", { tenantId });
+    }
+    deleteTenant(tenantId) {
+        this.tenants.delete(tenantId);
+        this.resourceUsage.delete(tenantId);
+        this.tenantData.delete(tenantId);
+        this.emit("tenant:deleted", { tenantId });
+    }
+    suspendTenant(tenantId) {
+        const tenant = this.tenants.get(tenantId);
+        if (tenant) {
+            tenant.status = TenantStatus.SUSPENDED;
+            this.emit("tenant:suspended", { tenantId });
+        }
+    }
+    // Resource Quotas
+    getQuota(tenantId) {
+        const tenant = this.tenants.get(tenantId);
+        return tenant?.quota;
+    }
+    updateQuota(tenantId, quota) {
+        const tenant = this.tenants.get(tenantId);
+        if (!tenant) {
+            throw new Error(`Tenant ${tenantId} not found`);
+        }
+        tenant.quota = quota;
+        this.emit("quota:updated", { tenantId });
+    }
+    checkQuotaExceeded(tenantId) {
+        const usage = this.resourceUsage.get(tenantId);
+        const quota = this.getQuota(tenantId);
+        if (!usage || !quota) {
+            return [];
+        }
+        const exceeded = [];
+        if (usage.requests >= quota.maxRequests)
+            exceeded.push("maxRequests");
+        if (usage.storage >= quota.maxStorage)
+            exceeded.push("maxStorage");
+        if (usage.users >= quota.maxUsers)
+            exceeded.push("maxUsers");
+        if (usage.apiKeys >= quota.maxApiKeys)
+            exceeded.push("maxApiKeys");
+        return exceeded;
+    }
+    // Resource Usage Tracking
+    recordUsage(tenantId, metric, amount = 1) {
+        const usage = this.resourceUsage.get(tenantId);
+        if (!usage) {
+            throw new Error(`Tenant ${tenantId} not found`);
+        }
+        if (metric !== "tenantId") {
+            usage[metric] += amount;
+        }
+        this.emit("usage:recorded", { tenantId, metric, amount });
+    }
+    getResourceUsage(tenantId) {
+        return this.resourceUsage.get(tenantId);
+    }
+    resetUsage(tenantId) {
+        const usage = this.resourceUsage.get(tenantId);
+        if (!usage) {
+            throw new Error(`Tenant ${tenantId} not found`);
+        }
+        usage.requests = 0;
+        usage.storage = 0;
+        usage.users = 0;
+        usage.apiKeys = 0;
+        this.emit("usage:reset", { tenantId });
+    }
+    // Tenant Context
+    pushContext(context) {
+        this.contextStack.push(context);
+        this.emit("context:pushed", { tenantId: context.tenantId });
+    }
+    popContext() {
+        return this.contextStack.pop();
+    }
+    getCurrentContext() {
+        return this.contextStack[this.contextStack.length - 1];
+    }
+    setContextPermissions(tenantId, permissions) {
+        const context = this.contextStack.find((c) => c.tenantId === tenantId);
+        if (context) {
+            context.permissions = permissions;
+            this.emit("context:permissions-updated", { tenantId });
+        }
+    }
+    // Data Isolation
+    setTenantData(tenantId, key, value) {
+        const tenant = this.getTenant(tenantId);
+        if (!tenant) {
+            throw new Error(`Tenant ${tenantId} not found`);
+        }
+        let data = this.tenantData.get(tenantId);
+        if (!data) {
+            data = new Map();
+            this.tenantData.set(tenantId, data);
+        }
+        data.set(key, value);
+        this.emit("data:stored", { tenantId, key });
+    }
+    getTenantData(tenantId, key) {
+        const data = this.tenantData.get(tenantId);
+        return data ? data.get(key) : undefined;
+    }
+    getTenantDataKeys(tenantId) {
+        const data = this.tenantData.get(tenantId);
+        return data ? Array.from(data.keys()) : [];
+    }
+    deleteTenantData(tenantId, key) {
+        const data = this.tenantData.get(tenantId);
+        if (data) {
+            data.delete(key);
+            this.emit("data:deleted", { tenantId, key });
+        }
+    }
+    clearTenantData(tenantId) {
+        this.tenantData.delete(tenantId);
+        this.tenantData.set(tenantId, new Map());
+        this.emit("data:cleared", { tenantId });
+    }
+    // Data Access Control
+    canAccessTenantData(context, targetTenantId) {
+        if (context.tenantId === targetTenantId) {
+            return true;
+        }
+        return context.permissions.includes(`access:${targetTenantId}`);
+    }
+}
+exports.MultiTenantManager = MultiTenantManager;
+class MultiTenantBuilder {
+    manager;
+    constructor() {
+        this.manager = new MultiTenantManager();
+    }
+    addTenant(config) {
+        this.manager.createTenant(config);
+        return this;
+    }
+    build() {
+        return this.manager;
+    }
+    getManager() {
+        return this.manager;
+    }
+}
+exports.MultiTenantBuilder = MultiTenantBuilder;
+//# sourceMappingURL=multi-tenant.js.map

package/dist/libs/multi-tenant.js.map

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

package/dist/libs/observability.d.ts

@@ -0,0 +1,105 @@
+import EventEmitter from "events";
+export declare enum MetricType {
+    COUNTER = "counter",
+    GAUGE = "gauge",
+    HISTOGRAM = "histogram",
+    TIMER = "timer"
+}
+export interface MetricValue {
+    name: string;
+    type: MetricType;
+    value: number;
+    timestamp: number;
+    tags: Map<string, string>;
+}
+export interface HistogramBucket {
+    le: number;
+    count: number;
+}
+export interface TraceContext {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    timestamp: number;
+}
+export interface Span {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    name: string;
+    startTime: number;
+    endTime?: number;
+    duration?: number;
+    tags: Map<string, string>;
+    logs: Array<{
+        timestamp: number;
+        message: string;
+    }>;
+    status: "UNSET" | "OK" | "ERROR";
+}
+export declare class MetricsCollector extends EventEmitter {
+    private counters;
+    private gauges;
+    private histograms;
+    private timers;
+    private history;
+    private maxHistorySize;
+    private buckets;
+    constructor();
+    private initializeBuckets;
+    incrementCounter(name: string, increment?: number, tags?: Map<string, string>): void;
+    getCounter(name: string): number;
+    setGauge(name: string, value: number, tags?: Map<string, string>): void;
+    getGauge(name: string): number | undefined;
+    recordHistogramValue(name: string, value: number, tags?: Map<string, string>): void;
+    getHistogramStatistics(name: string): {
+        count: number;
+        sum: number;
+        min: number;
+        max: number;
+        avg: number;
+        p50: number;
+        p95: number;
+        p99: number;
+    } | null;
+    startTimer(name: string): () => void;
+    recordTiming(name: string, duration: number, tags?: Map<string, string>): void;
+    getAllMetrics(): {
+        counters: Map<string, number>;
+        gauges: Map<string, number>;
+        histograms: Map<string, number[]>;
+        timers: Map<string, number[]>;
+    };
+    getMetricsHistory(limit?: number): MetricValue[];
+    reset(): void;
+}
+export declare class TracingCollector extends EventEmitter {
+    private spans;
+    private traceTree;
+    createSpan(traceId: string, spanId: string, name: string, parentSpanId?: string): Span;
+    getSpan(traceId: string, spanId: string): Span | undefined;
+    addSpanTag(traceId: string, spanId: string, key: string, value: string): boolean;
+    addSpanLog(traceId: string, spanId: string, message: string): boolean;
+    finishSpan(traceId: string, spanId: string, status?: "OK" | "ERROR"): Span | undefined;
+    getTrace(traceId: string): Span[];
+    getAllSpans(): Span[];
+    getTraceStats(traceId: string): {
+        spanCount: number;
+        totalDuration: number;
+        errorCount: number;
+    } | null;
+    clearTrace(traceId: string): number;
+    reset(): void;
+}
+export declare class ObservabilityBuilder {
+    private metricsCollector;
+    private tracingCollector;
+    constructor();
+    getMetricsCollector(): MetricsCollector;
+    getTracingCollector(): TracingCollector;
+    build(): {
+        metrics: MetricsCollector;
+        tracing: TracingCollector;
+    };
+}
+//# sourceMappingURL=observability.d.ts.map

package/dist/libs/observability.d.ts.map

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