@qduc/term2 0.5.0 → 0.6.1

package/dist/services/history-service.test.js

@@ -0,0 +1,77 @@
+import test from 'ava';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { HistoryService } from './history-service.js';
+const createDeps = (historyFile) => ({
+    historyFile,
+    loggingService: {
+        error: () => { },
+        warn: () => { },
+        info: () => { },
+        debug: () => { },
+        security: () => { },
+        setCorrelationId: () => { },
+        clearCorrelationId: () => { },
+    },
+    settingsService: {
+        get: () => 1000,
+    },
+});
+const createTempHistoryFile = () => {
+    const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'term2-history-'));
+    return { dir, historyFile: path.join(dir, 'history.json') };
+};
+const image = {
+    id: 'img-1',
+    data: 'abc123',
+    mimeType: 'image/png',
+    byteSize: 3,
+    displayNumber: 1,
+};
+test('addMessage() stores multimodal turns and persists them', (t) => {
+    const { dir, historyFile } = createTempHistoryFile();
+    try {
+        const service = new HistoryService(createDeps(historyFile));
+        const turn = { text: 'Describe this', images: [image] };
+        service.addMessage(turn);
+        t.deepEqual(service.getTurns(), [turn]);
+        t.deepEqual(service.getMessages(), ['Describe this']);
+        const written = JSON.parse(fs.readFileSync(historyFile, 'utf-8'));
+        t.deepEqual(written.messages, [turn]);
+        const reloaded = new HistoryService(createDeps(historyFile));
+        t.deepEqual(reloaded.getTurns(), [turn]);
+    }
+    finally {
+        fs.rmSync(dir, { recursive: true, force: true });
+    }
+});
+test('addMessage() stores image-only turns', (t) => {
+    const { dir, historyFile } = createTempHistoryFile();
+    try {
+        const service = new HistoryService(createDeps(historyFile));
+        service.addMessage({
+            text: '',
+            images: [image],
+        });
+        t.is(service.getTurns().length, 1);
+        t.deepEqual(service.getTurns()[0], { text: '', images: [image] });
+        t.deepEqual(service.getMessages(), ['']);
+    }
+    finally {
+        fs.rmSync(dir, { recursive: true, force: true });
+    }
+});
+test('load() supports legacy string-only history files', (t) => {
+    const { dir, historyFile } = createTempHistoryFile();
+    try {
+        fs.writeFileSync(historyFile, JSON.stringify({ messages: ['First', 'Second'] }, null, 2), 'utf-8');
+        const service = new HistoryService(createDeps(historyFile));
+        t.deepEqual(service.getTurns(), [{ text: 'First' }, { text: 'Second' }]);
+        t.deepEqual(service.getMessages(), ['First', 'Second']);
+    }
+    finally {
+        fs.rmSync(dir, { recursive: true, force: true });
+    }
+});
+//# sourceMappingURL=history-service.test.js.map

package/dist/services/history-service.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-service.test.js","sourceRoot":"","sources":["../../source/services/history-service.test.ts"],"names":[],"mappings":"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"}

package/dist/services/input-surge-guard.d.ts

@@ -0,0 +1,37 @@
+export interface InputSurgeStats {
+    messageCount: number;
+    totalSerializedBytes: number;
+    duplicateToolCallSignatures: number;
+    maxDuplicateToolCallSignatureCount: number;
+}
+export interface InputSurgeGuardConfig {
+    maxMessageGrowthRatio: number;
+    minMessageGrowthForRatioBlock: number;
+    maxSerializedByteGrowthRatio: number;
+    minSerializedByteGrowthForRatioBlock: number;
+    maxDuplicateToolCallSignatureCount: number;
+    minDuplicateToolCallSignaturesForBlock: number;
+}
+export interface InputSurgeDecision {
+    action: 'allow' | 'block';
+    reason?: string;
+    stats: InputSurgeStats;
+    previousStats?: InputSurgeStats;
+}
+export type InputSurgeInputKind = 'delta' | 'full_history';
+export interface InputSurgeInspectOptions {
+    kind?: InputSurgeInputKind;
+}
+export interface InputSurgeRecordOptions extends InputSurgeInspectOptions {
+    previousInput?: unknown;
+}
+export declare const DEFAULT_INPUT_SURGE_GUARD_CONFIG: InputSurgeGuardConfig;
+export declare const collectInputSurgeStats: (input: unknown) => InputSurgeStats;
+export declare class InputSurgeGuard {
+    #private;
+    constructor(config?: Partial<InputSurgeGuardConfig>);
+    reset(): void;
+    inspect(input: unknown, options?: InputSurgeInspectOptions): InputSurgeDecision;
+    recordSuccessfulInput(input: unknown, options?: InputSurgeRecordOptions): void;
+}
+//# sourceMappingURL=input-surge-guard.d.ts.map

package/dist/services/input-surge-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-surge-guard.d.ts","sourceRoot":"","sources":["../../source/services/input-surge-guard.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,2BAA2B,EAAE,MAAM,CAAC;IACpC,kCAAkC,EAAE,MAAM,CAAC;CAC5C;AAED,MAAM,WAAW,qBAAqB;IACpC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,6BAA6B,EAAE,MAAM,CAAC;IACtC,4BAA4B,EAAE,MAAM,CAAC;IACrC,oCAAoC,EAAE,MAAM,CAAC;IAC7C,kCAAkC,EAAE,MAAM,CAAC;IAC3C,sCAAsC,EAAE,MAAM,CAAC;CAChD;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,eAAe,CAAC;IACvB,aAAa,CAAC,EAAE,eAAe,CAAC;CACjC;AAED,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,cAAc,CAAC;AAE3D,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,EAAE,mBAAmB,CAAC;CAC5B;AAED,MAAM,WAAW,uBAAwB,SAAQ,wBAAwB;IACvE,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,eAAO,MAAM,gCAAgC,EAAE,qBAO9C,CAAC;AA8CF,eAAO,MAAM,sBAAsB,GAAI,OAAO,OAAO,KAAG,eAoBvD,CAAC;AAwDF,qBAAa,eAAe;;gBAKd,MAAM,GAAE,OAAO,CAAC,qBAAqB,CAAM;IAIvD,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,wBAA6B,GAAG,kBAAkB;IAoEnF,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,uBAA4B,GAAG,IAAI;CAgBnF"}

package/dist/services/input-surge-guard.js

@@ -0,0 +1,190 @@
+export const DEFAULT_INPUT_SURGE_GUARD_CONFIG = {
+    maxMessageGrowthRatio: 3,
+    minMessageGrowthForRatioBlock: 100,
+    maxSerializedByteGrowthRatio: 5,
+    minSerializedByteGrowthForRatioBlock: 100_000,
+    maxDuplicateToolCallSignatureCount: 4,
+    minDuplicateToolCallSignaturesForBlock: 20,
+};
+const asRecord = (value) => value && typeof value === 'object' && !Array.isArray(value) ? value : null;
+const toolCallSignature = (item) => {
+    const record = asRecord(item);
+    if (!record) {
+        return null;
+    }
+    const raw = asRecord(record.rawItem) ?? record;
+    const callId = raw.callId ?? raw.call_id ?? raw.tool_call_id;
+    const type = raw.type;
+    if (typeof callId !== 'string' || !callId || typeof type !== 'string' || !type) {
+        return null;
+    }
+    return `${type}:${callId}`;
+};
+const toolCallRecord = (item) => {
+    const record = asRecord(item);
+    if (!record) {
+        return null;
+    }
+    const raw = asRecord(record.rawItem) ?? record;
+    const callId = raw.callId ?? raw.call_id ?? raw.tool_call_id;
+    const type = raw.type;
+    if (typeof callId !== 'string' || !callId || typeof type !== 'string' || !type) {
+        return null;
+    }
+    return { callId, type };
+};
+const serializedBytes = (input) => {
+    try {
+        const serialized = JSON.stringify(input);
+        return Buffer.byteLength(serialized ?? String(input));
+    }
+    catch {
+        return Buffer.byteLength(String(input));
+    }
+};
+export const collectInputSurgeStats = (input) => {
+    const items = Array.isArray(input) ? input : [input];
+    const toolCallCounts = new Map();
+    for (const item of items) {
+        const signature = toolCallSignature(item);
+        if (!signature) {
+            continue;
+        }
+        toolCallCounts.set(signature, (toolCallCounts.get(signature) ?? 0) + 1);
+    }
+    const duplicateCounts = [...toolCallCounts.values()].filter((count) => count > 1);
+    return {
+        messageCount: items.length,
+        totalSerializedBytes: serializedBytes(input),
+        duplicateToolCallSignatures: duplicateCounts.length,
+        maxDuplicateToolCallSignatureCount: duplicateCounts.length > 0 ? Math.max(...duplicateCounts) : 0,
+    };
+};
+const countDuplicateToolCallResultPairs = (input) => {
+    const items = Array.isArray(input) ? input : [input];
+    const calls = new Map();
+    const results = new Map();
+    for (const item of items) {
+        const record = toolCallRecord(item);
+        if (!record) {
+            continue;
+        }
+        if (record.type === 'function_call') {
+            calls.set(record.callId, (calls.get(record.callId) ?? 0) + 1);
+        }
+        if (record.type === 'function_call_result') {
+            results.set(record.callId, (results.get(record.callId) ?? 0) + 1);
+        }
+    }
+    let pairs = 0;
+    let maxCopies = 0;
+    for (const [callId, callCount] of calls) {
+        const copies = Math.min(callCount, results.get(callId) ?? 0);
+        if (copies < 2) {
+            continue;
+        }
+        pairs++;
+        maxCopies = Math.max(maxCopies, copies);
+    }
+    return { pairs, maxCopies };
+};
+const getAppendedItems = (previousInput, input) => {
+    const items = Array.isArray(input) ? input : [input];
+    if (!Array.isArray(previousInput) || !Array.isArray(input) || input.length < previousInput.length) {
+        return items;
+    }
+    return input.slice(previousInput.length);
+};
+const getLargestToolResultBytes = (items) => {
+    let largest = 0;
+    for (const item of items) {
+        const record = toolCallRecord(item);
+        if (record?.type !== 'function_call_result') {
+            continue;
+        }
+        largest = Math.max(largest, serializedBytes(item));
+    }
+    return largest;
+};
+export class InputSurgeGuard {
+    #lastSuccessfulStats = new Map();
+    #pendingBlocks = new Map();
+    #config;
+    constructor(config = {}) {
+        this.#config = { ...DEFAULT_INPUT_SURGE_GUARD_CONFIG, ...config };
+    }
+    reset() {
+        this.#lastSuccessfulStats.clear();
+        this.#pendingBlocks.clear();
+    }
+    inspect(input, options = {}) {
+        const kind = options.kind ?? 'full_history';
+        const stats = collectInputSurgeStats(input);
+        const pendingBlock = this.#pendingBlocks.get(kind);
+        if (pendingBlock) {
+            this.#pendingBlocks.delete(kind);
+            return {
+                action: 'block',
+                reason: pendingBlock.reason,
+                stats,
+                previousStats: pendingBlock.previousStats,
+            };
+        }
+        const previousStats = this.#lastSuccessfulStats.get(kind);
+        const duplicatePairs = countDuplicateToolCallResultPairs(input);
+        if (duplicatePairs.pairs >= 3 && duplicatePairs.maxCopies >= 2) {
+            return {
+                action: 'block',
+                reason: `Detected replayed tool call/result pairs: ${duplicatePairs.pairs} duplicated pairs, max repetition ${duplicatePairs.maxCopies}.`,
+                stats,
+                previousStats,
+            };
+        }
+        if (previousStats &&
+            stats.messageCount - previousStats.messageCount >= this.#config.minMessageGrowthForRatioBlock &&
+            stats.messageCount > previousStats.messageCount * this.#config.maxMessageGrowthRatio) {
+            return {
+                action: 'block',
+                reason: `Outgoing message count jumped from ${previousStats.messageCount} to ${stats.messageCount}.`,
+                stats,
+                previousStats,
+            };
+        }
+        if (previousStats &&
+            stats.totalSerializedBytes - previousStats.totalSerializedBytes >=
+                this.#config.minSerializedByteGrowthForRatioBlock &&
+            stats.totalSerializedBytes > previousStats.totalSerializedBytes * this.#config.maxSerializedByteGrowthRatio) {
+            return {
+                action: 'block',
+                reason: `Outgoing input size jumped from ${previousStats.totalSerializedBytes} to ${stats.totalSerializedBytes} bytes.`,
+                stats,
+                previousStats,
+            };
+        }
+        if (stats.maxDuplicateToolCallSignatureCount >= this.#config.maxDuplicateToolCallSignatureCount &&
+            stats.duplicateToolCallSignatures >= this.#config.minDuplicateToolCallSignaturesForBlock) {
+            return {
+                action: 'block',
+                reason: `Detected replayed tool-call history: ${stats.duplicateToolCallSignatures} duplicated tool-call signatures, max repetition ${stats.maxDuplicateToolCallSignatureCount}.`,
+                stats,
+                previousStats,
+            };
+        }
+        return { action: 'allow', stats, previousStats };
+    }
+    recordSuccessfulInput(input, options = {}) {
+        const kind = options.kind ?? 'full_history';
+        const stats = collectInputSurgeStats(input);
+        if (options.previousInput !== undefined) {
+            const largestAppendedToolResult = getLargestToolResultBytes(getAppendedItems(options.previousInput, input));
+            if (largestAppendedToolResult >= this.#config.minSerializedByteGrowthForRatioBlock) {
+                this.#pendingBlocks.set(kind, {
+                    reason: `New tool result added ${largestAppendedToolResult} serialized bytes to outgoing history.`,
+                    previousStats: collectInputSurgeStats(options.previousInput),
+                });
+            }
+        }
+        this.#lastSuccessfulStats.set(kind, stats);
+    }
+}
+//# sourceMappingURL=input-surge-guard.js.map

package/dist/services/input-surge-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-surge-guard.js","sourceRoot":"","sources":["../../source/services/input-surge-guard.ts"],"names":[],"mappings":"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"}

package/dist/services/input-surge-guard.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=input-surge-guard.test.d.ts.map

package/dist/services/input-surge-guard.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-surge-guard.test.d.ts","sourceRoot":"","sources":["../../source/services/input-surge-guard.test.ts"],"names":[],"mappings":""}

package/dist/services/input-surge-guard.test.js

@@ -0,0 +1,126 @@
+import test from 'ava';
+import { collectInputSurgeStats, InputSurgeGuard } from './input-surge-guard.js';
+const toolCall = (callId, type = 'function_call') => ({
+    type,
+    callId,
+});
+test('collectInputSurgeStats counts messages and duplicated tool-call signatures', (t) => {
+    const stats = collectInputSurgeStats([
+        { role: 'user', type: 'message', content: 'hello' },
+        toolCall('call-1'),
+        toolCall('call-1'),
+        toolCall('call-1', 'function_call_result'),
+        toolCall('call-1', 'function_call_result'),
+        toolCall('call-2'),
+    ]);
+    t.deepEqual(stats, {
+        messageCount: 6,
+        totalSerializedBytes: 281,
+        duplicateToolCallSignatures: 2,
+        maxDuplicateToolCallSignatureCount: 2,
+    });
+});
+test('InputSurgeGuard blocks abrupt message-count growth from last successful input', (t) => {
+    const guard = new InputSurgeGuard();
+    guard.recordSuccessfulInput(Array.from({ length: 65 }, (_, index) => ({ role: 'user', content: `m${index}` })));
+    const decision = guard.inspect(Array.from({ length: 863 }, (_, index) => ({ role: 'user', content: `m${index}` })));
+    t.is(decision.action, 'block');
+    t.true(decision.reason?.includes('65 to 863'));
+});
+test('InputSurgeGuard blocks abrupt serialized byte growth from last successful input', (t) => {
+    const guard = new InputSurgeGuard();
+    guard.recordSuccessfulInput([{ role: 'user', type: 'message', content: 'small' }]);
+    const decision = guard.inspect([{ type: 'function_call_result', callId: 'call-1', output: 'x'.repeat(150_000) }]);
+    t.is(decision.action, 'block');
+    t.true(decision.reason?.includes('input size jumped'));
+});
+test('InputSurgeGuard allows large absolute growth below the minimum surge threshold', (t) => {
+    const guard = new InputSurgeGuard();
+    guard.recordSuccessfulInput(Array.from({ length: 1 }, (_, index) => ({ role: 'user', content: `m${index}` })));
+    const decision = guard.inspect(Array.from({ length: 65 }, (_, index) => ({ role: 'user', content: `m${index}` })));
+    t.is(decision.action, 'allow');
+});
+test('InputSurgeGuard blocks replayed tool-call signatures even without a baseline', (t) => {
+    const guard = new InputSurgeGuard();
+    const input = [];
+    for (let call = 0; call < 20; call++) {
+        for (let repetition = 0; repetition < 4; repetition++) {
+            input.push(toolCall(`call-${call}`));
+        }
+    }
+    const decision = guard.inspect(input);
+    t.is(decision.action, 'block');
+    t.true(decision.reason?.includes('replayed tool-call history'));
+});
+test('InputSurgeGuard compares growth baselines only within the same input kind', (t) => {
+    const guard = new InputSurgeGuard();
+    guard.recordSuccessfulInput([{ role: 'user', type: 'message', content: 'small delta' }], { kind: 'delta' });
+    const decision = guard.inspect(Array.from({ length: 212 }, (_, index) => ({ role: 'user', type: 'message', content: `history-${index}` })), { kind: 'full_history' });
+    t.is(decision.action, 'allow');
+    t.is(decision.previousStats, undefined);
+});
+test('InputSurgeGuard blocks duplicate tool call and result pairs at two copies', (t) => {
+    const guard = new InputSurgeGuard();
+    const pair = (callId) => [
+        toolCall(callId),
+        { type: 'function_call_result', callId, output: { type: 'text', text: `result-${callId}` } },
+    ];
+    const decision = guard.inspect([
+        ...pair('call-1'),
+        ...pair('call-2'),
+        ...pair('call-3'),
+        ...pair('call-1'),
+        ...pair('call-2'),
+        ...pair('call-3'),
+    ]);
+    t.is(decision.action, 'block');
+    t.true(decision.reason?.includes('tool call/result pairs'));
+});
+test('InputSurgeGuard blocks a large tool result appended after a successful full-history request', (t) => {
+    const guard = new InputSurgeGuard();
+    const requestHistory = [{ role: 'user', type: 'message', content: 'inspect files' }];
+    const postRunHistory = [
+        ...requestHistory,
+        toolCall('call-large'),
+        { type: 'function_call_result', callId: 'call-large', output: 'x'.repeat(150_000) },
+    ];
+    guard.recordSuccessfulInput(postRunHistory, { kind: 'full_history', previousInput: requestHistory });
+    const decision = guard.inspect([...postRunHistory, { role: 'user', type: 'message', content: 'follow up' }], {
+        kind: 'full_history',
+    });
+    t.is(decision.action, 'block');
+    t.true(decision.reason?.includes('tool result'));
+});
+test('InputSurgeGuard does not update baseline for blocked input', (t) => {
+    const guard = new InputSurgeGuard();
+    guard.recordSuccessfulInput(Array.from({ length: 65 }, (_, index) => ({ role: 'user', content: `m${index}` })));
+    const blocked = Array.from({ length: 863 }, (_, index) => ({ role: 'user', content: `m${index}` }));
+    t.is(guard.inspect(blocked).action, 'block');
+    const stillComparedToOriginal = guard.inspect(Array.from({ length: 200 }, (_, index) => ({ role: 'user', content: `m${index}` })));
+    t.is(stillComparedToOriginal.action, 'block');
+    t.is(stillComparedToOriginal.previousStats?.messageCount, 65);
+});
+test('InputSurgeGuard pending block fires once then clears', (t) => {
+    const guard = new InputSurgeGuard();
+    const requestHistory = [{ role: 'user', type: 'message', content: 'first query' }];
+    const postRunHistory = [
+        ...requestHistory,
+        { type: 'function_call', callId: 'call-large' },
+        { type: 'function_call_result', callId: 'call-large', output: 'x'.repeat(150_000) },
+    ];
+    // Record the successful input with a large appended tool result — this sets a pending block.
+    guard.recordSuccessfulInput(postRunHistory, { kind: 'full_history', previousInput: requestHistory });
+    // First inspect after the large tool result: pending block fires.
+    const firstDecision = guard.inspect([...postRunHistory, { role: 'user', content: 'follow up' }], {
+        kind: 'full_history',
+    });
+    t.is(firstDecision.action, 'block');
+    t.true(firstDecision.reason?.includes('tool result'));
+    // Second inspect with same kind: pending block is gone, so only a real surge would block.
+    const secondDecision = guard.inspect([...postRunHistory, { role: 'user', content: 'another follow up' }], {
+        kind: 'full_history',
+    });
+    // The history is now ~4 messages, well within normal growth — so it should be allowed.
+    t.is(secondDecision.action, 'allow');
+});
+//# sourceMappingURL=input-surge-guard.test.js.map

package/dist/services/input-surge-guard.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-surge-guard.test.js","sourceRoot":"","sources":["../../source/services/input-surge-guard.test.ts"],"names":[],"mappings":"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"}

package/dist/services/logging-contract.d.ts

@@ -12,9 +12,9 @@ export declare const RuntimeLogSchema: z.ZodObject<{
     model: z.ZodString;
     phase: z.ZodEnum<{
         abort: "abort";
-        execution: "execution";
         request_start: "request_start";
         provider_response: "provider_response";
+        execution: "execution";
         approval: "approval";
         retry: "retry";
         normalization: "normalization";

package/dist/services/logging-service.d.ts

@@ -1,3 +1,4 @@
+import { type SessionTrafficContext } from './provider-traffic.js';
 interface LoggingServiceConfig {
     logDir?: string;
     logLevel?: string;
@@ -28,6 +29,7 @@ export declare class LoggingService {
     private enabledCategories;
     private verbosePayloads;
     private sampleRate;
+    private providerTrafficStore;
     constructor(config?: LoggingServiceConfig);
     /**
      * Return the current effective log level for the logger
@@ -70,6 +72,8 @@ export declare class LoggingService {
      * Get correlation ID
      */
     getCorrelationId(): string | undefined;
+    runWithTrafficContext<T>(context: SessionTrafficContext, fn: () => T): T;
+    getTrafficContext(): SessionTrafficContext | null;
     /**
      * Remove provider and evaluator traffic logs older than maxFiles (default 30d)
      */

package/dist/services/logging-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logging-service.d.ts","sourceRoot":"","sources":["../../source/services/logging-service.ts"],"names":[],"mappings":"AAqCA,UAAU,oBAAoB;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED;;;;;;;;;;GAUG;AACH,qBAAa,cAAc;;IACzB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,qBAAqB,CAAU;IACvC,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,iBAAiB,CAA0B;IACnD,OAAO,CAAC,eAAe,CAAU;IACjC,OAAO,CAAC,UAAU,CAAS;gBAEf,MAAM,GAAE,oBAAyB;IAkG7C;;OAEG;IACH,WAAW,IAAI,MAAM;IAQrB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAI9C;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAuBhC;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAIxD;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAIvD;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAIvD;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAI3D;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAIxD;;OAEG;IACH,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIlC;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAI1B;;OAEG;IACH,gBAAgB,IAAI,MAAM,GAAG,SAAS;IAItC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAK9B,OAAO,CAAC,iBAAiB;IAoCzB,OAAO,CAAC,GAAG;IAuEX,OAAO,CAAC,4BAA4B;IAmCpC,OAAO,CAAC,gBAAgB;CAMzB;AA8BD,eAAO,MAAM,cAAc,gBAyBzB,CAAC"}
+{"version":3,"file":"logging-service.d.ts","sourceRoot":"","sources":["../../source/services/logging-service.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAgC,KAAK,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAmBjG,UAAU,oBAAoB;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED;;;;;;;;;;GAUG;AACH,qBAAa,cAAc;;IAEzB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,qBAAqB,CAAU;IACvC,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,iBAAiB,CAA0B;IACnD,OAAO,CAAC,eAAe,CAAU;IACjC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,oBAAoB,CAA+B;gBAE/C,MAAM,GAAE,oBAAyB;IAmG7C;;OAEG;IACH,WAAW,IAAI,MAAM;IAQrB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAI9C;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAuBhC;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAIxD;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAIvD;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAIvD;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAI3D;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAIxD;;OAEG;IACH,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIlC;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAI1B;;OAEG;IACH,gBAAgB,IAAI,MAAM,GAAG,SAAS;IAItC,qBAAqB,CAAC,CAAC,EAAE,OAAO,EAAE,qBAAqB,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAIxE,iBAAiB,IAAI,qBAAqB,GAAG,IAAI;IAIjD;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAK9B,OAAO,CAAC,iBAAiB;IA8CzB,OAAO,CAAC,GAAG;IAuEX,OAAO,CAAC,4BAA4B;IAgFpC,OAAO,CAAC,gBAAgB;CAMzB;AA8BD,eAAO,MAAM,cAAc,gBAyBzB,CAAC"}