@qduc/term2 0.9.4 → 0.10.0

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

@@ -1,74 +0,0 @@
-import { z } from 'zod';
-export declare const LOG_CATEGORIES: readonly ["provider", "tool", "stream", "approval", "retry", "general"];
-export type LogCategory = (typeof LOG_CATEGORIES)[number];
-export declare const RuntimeLogSchema: z.ZodObject<{
-    timestamp: z.ZodString;
-    level: z.ZodString;
-    eventType: z.ZodString;
-    traceId: z.ZodString;
-    sessionId: z.ZodString;
-    messageId: z.ZodString;
-    provider: z.ZodString;
-    model: z.ZodString;
-    phase: z.ZodEnum<{
-        abort: "abort";
-        retry: "retry";
-        request_start: "request_start";
-        provider_response: "provider_response";
-        execution: "execution";
-        approval: "approval";
-        normalization: "normalization";
-        validation: "validation";
-        runtime: "runtime";
-    }>;
-    toolName: z.ZodOptional<z.ZodString>;
-    toolCallId: z.ZodOptional<z.ZodString>;
-    retryType: z.ZodOptional<z.ZodString>;
-    retryAttempt: z.ZodOptional<z.ZodNumber>;
-    errorCode: z.ZodOptional<z.ZodString>;
-    errorMessage: z.ZodOptional<z.ZodString>;
-    payloadRef: z.ZodOptional<z.ZodString>;
-    category: z.ZodOptional<z.ZodEnum<{
-        retry: "retry";
-        provider: "provider";
-        tool: "tool";
-        stream: "stream";
-        approval: "approval";
-        general: "general";
-    }>>;
-}, z.core.$loose>;
-export declare const resolveLogCategory: ({ eventType, explicitCategory, }: {
-    eventType?: unknown;
-    explicitCategory?: unknown;
-}) => LogCategory;
-export declare const buildRuntimeLogRecord: ({ timestamp, level, correlationId, meta, }: {
-    timestamp?: string;
-    level: string;
-    correlationId?: string;
-    meta?: Record<string, unknown>;
-}) => Record<string, unknown>;
-export declare const parseCategoryFilter: (raw: string | undefined) => Set<LogCategory> | null;
-export declare const shouldLogForCategory: ({ level, category, enabledCategories, }: {
-    level: string;
-    category: LogCategory;
-    enabledCategories: Set<LogCategory> | null;
-}) => boolean;
-export declare const shouldIncludeVerbosePayload: ({ level, verbosePayloads, }: {
-    level: string;
-    verbosePayloads: boolean;
-}) => boolean;
-export declare const shouldSampleLog: ({ level, sampleRate, randomValue, }: {
-    level: string;
-    sampleRate: number;
-    randomValue: number;
-}) => boolean;
-export declare const createInvalidToolCallDiagnostic: ({ toolName, toolCallId, rawPayload, normalizedToolCall, validationErrors, traceId, retryContext, }: {
-    toolName: string;
-    toolCallId: string;
-    rawPayload: string;
-    normalizedToolCall: Record<string, unknown>;
-    validationErrors: string[];
-    traceId: string;
-    retryContext: Record<string, unknown>;
-}) => Record<string, unknown>;
-//# sourceMappingURL=logging-contract.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"logging-contract.d.ts","sourceRoot":"","sources":["../../source/services/logging-contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,cAAc,yEAA0E,CAAC;AACtG,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAc1D,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoBb,CAAC;AAcjB,eAAO,MAAM,kBAAkB,GAAI,kCAGhC;IACD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,KAAG,WAgBH,CAAC;AAwBF,eAAO,MAAM,qBAAqB,GAAI,4CAKnC;IACD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CA0BzB,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,KAAK,MAAM,GAAG,SAAS,KAAG,GAAG,CAAC,WAAW,CAAC,GAAG,IAehF,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,yCAIlC;IACD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,WAAW,CAAC;IACtB,iBAAiB,EAAE,GAAG,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;CAC5C,KAAG,OAUH,CAAC;AAEF,eAAO,MAAM,2BAA2B,GAAI,6BAGzC;IACD,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,OAAO,CAAC;CAC1B,KAAG,OAKH,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,qCAI7B;IACD,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB,KAAG,OAcH,CAAC;AAEF,eAAO,MAAM,+BAA+B,GAAI,oGAQ7C;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAezB,CAAC"}

package/dist/services/logging-contract.js

@@ -1,157 +0,0 @@
-import { z } from 'zod';
-export const LOG_CATEGORIES = ['provider', 'tool', 'stream', 'approval', 'retry', 'general'];
-const LOG_PHASES = [
-    'request_start',
-    'provider_response',
-    'normalization',
-    'validation',
-    'approval',
-    'execution',
-    'retry',
-    'abort',
-    'runtime',
-];
-export const RuntimeLogSchema = z
-    .object({
-    timestamp: z.string().min(1),
-    level: z.string().min(1),
-    eventType: z.string().min(1),
-    traceId: z.string().min(1),
-    sessionId: z.string().min(1),
-    messageId: z.string().min(1),
-    provider: z.string().min(1),
-    model: z.string().min(1),
-    phase: z.enum(LOG_PHASES),
-    toolName: z.string().min(1).optional(),
-    toolCallId: z.string().min(1).optional(),
-    retryType: z.string().min(1).optional(),
-    retryAttempt: z.number().int().nonnegative().optional(),
-    errorCode: z.string().min(1).optional(),
-    errorMessage: z.string().min(1).optional(),
-    payloadRef: z.string().min(1).optional(),
-    category: z.enum(LOG_CATEGORIES).optional(),
-})
-    .passthrough();
-const looksLikeUuid = (value) => /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(value);
-const EVENT_CATEGORY_PREFIXES = [
-    { prefix: 'provider.', category: 'provider' },
-    { prefix: 'tool_call.', category: 'tool' },
-    { prefix: 'tool.', category: 'tool' },
-    { prefix: 'stream.', category: 'stream' },
-    { prefix: 'approval.', category: 'approval' },
-    { prefix: 'retry.', category: 'retry' },
-];
-export const resolveLogCategory = ({ eventType, explicitCategory, }) => {
-    if (typeof explicitCategory === 'string' && LOG_CATEGORIES.includes(explicitCategory)) {
-        return explicitCategory;
-    }
-    if (typeof eventType !== 'string' || !eventType.trim()) {
-        return 'general';
-    }
-    for (const entry of EVENT_CATEGORY_PREFIXES) {
-        if (eventType.startsWith(entry.prefix)) {
-            return entry.category;
-        }
-    }
-    return 'general';
-};
-const toNonEmptyString = (value, fallback) => {
-    if (typeof value === 'string' && value.trim()) {
-        return value.trim();
-    }
-    return fallback;
-};
-const toPhase = (value) => {
-    if (typeof value === 'string' && LOG_PHASES.includes(value)) {
-        return value;
-    }
-    return 'runtime';
-};
-const buildMessageId = (meta) => {
-    const candidate = meta.messageId;
-    if (typeof candidate === 'string' && candidate.trim()) {
-        return candidate.trim();
-    }
-    return `msg-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
-};
-export const buildRuntimeLogRecord = ({ timestamp, level, correlationId, meta = {}, }) => {
-    const traceCandidate = toNonEmptyString(meta.traceId ?? correlationId, 'trace-unknown');
-    const eventType = toNonEmptyString(meta.eventType, 'log.message');
-    const category = resolveLogCategory({ eventType, explicitCategory: meta.category });
-    const provider = toNonEmptyString(meta.provider, 'unknown');
-    const model = toNonEmptyString(meta.model, 'unknown');
-    const record = {
-        ...meta,
-        timestamp: timestamp ?? new Date().toISOString(),
-        level,
-        eventType,
-        traceId: traceCandidate,
-        sessionId: toNonEmptyString(meta.sessionId, 'session-unknown'),
-        messageId: buildMessageId(meta),
-        provider,
-        model,
-        phase: toPhase(meta.phase),
-        category,
-    };
-    if (!looksLikeUuid(traceCandidate) && correlationId && looksLikeUuid(correlationId)) {
-        record.traceId = correlationId;
-    }
-    return record;
-};
-export const parseCategoryFilter = (raw) => {
-    if (!raw || !raw.trim()) {
-        return null;
-    }
-    const values = raw
-        .split(',')
-        .map((part) => part.trim())
-        .filter((part) => LOG_CATEGORIES.includes(part));
-    if (!values.length) {
-        return null;
-    }
-    return new Set(values);
-};
-export const shouldLogForCategory = ({ level, category, enabledCategories, }) => {
-    if (!enabledCategories || enabledCategories.size === 0) {
-        return true;
-    }
-    if (level === 'error' || level === 'warn') {
-        return true;
-    }
-    return enabledCategories.has(category);
-};
-export const shouldIncludeVerbosePayload = ({ level, verbosePayloads, }) => {
-    if (verbosePayloads) {
-        return true;
-    }
-    return level === 'error';
-};
-export const shouldSampleLog = ({ level, sampleRate, randomValue, }) => {
-    if (level === 'error' || level === 'warn') {
-        return true;
-    }
-    if (!Number.isFinite(sampleRate) || sampleRate >= 1) {
-        return true;
-    }
-    if (sampleRate <= 0) {
-        return false;
-    }
-    return randomValue <= sampleRate;
-};
-export const createInvalidToolCallDiagnostic = ({ toolName, toolCallId, rawPayload, normalizedToolCall, validationErrors, traceId, retryContext, }) => {
-    return {
-        eventType: 'tool_call.parse_failed',
-        category: 'tool',
-        phase: 'validation',
-        errorCode: 'INVALID_TOOL_CALL_FORMAT',
-        errorMessage: 'Invalid tool call argument payload',
-        toolName,
-        toolCallId,
-        traceId,
-        rawPayloadSnippet: rawPayload.slice(0, 500),
-        normalizedToolCall,
-        validationErrors,
-        retryContext,
-    };
-};
-//# sourceMappingURL=logging-contract.js.map

package/dist/services/logging-contract.js.map

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

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

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

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

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

package/dist/services/logging-contract.test.js

@@ -1,66 +0,0 @@
-import test from 'ava';
-import { RuntimeLogSchema, buildRuntimeLogRecord, createInvalidToolCallDiagnostic, parseCategoryFilter, resolveLogCategory, shouldIncludeVerbosePayload, shouldLogForCategory, shouldSampleLog, } from './logging-contract.js';
-test('buildRuntimeLogRecord produces canonical required fields', (t) => {
-    const record = buildRuntimeLogRecord({
-        level: 'info',
-        correlationId: 'trace-123',
-        meta: {
-            eventType: 'stream.started',
-            phase: 'request_start',
-            sessionId: 'session-1',
-            provider: 'openai',
-            model: 'gpt-5',
-            messageId: 'msg-1',
-        },
-    });
-    const parsed = RuntimeLogSchema.parse(record);
-    t.is(parsed.traceId, 'trace-123');
-    t.is(parsed.eventType, 'stream.started');
-    t.is(parsed.phase, 'request_start');
-    t.is(parsed.category, 'stream');
-});
-test('parseCategoryFilter parses valid comma-separated categories', (t) => {
-    const parsed = parseCategoryFilter('retry, tool,invalid');
-    t.truthy(parsed);
-    t.true(parsed?.has('retry'));
-    t.true(parsed?.has('tool'));
-    t.false(parsed?.has('provider'));
-});
-test('shouldLogForCategory always keeps warn/error logs', (t) => {
-    const enabled = new Set(['tool']);
-    t.true(shouldLogForCategory({ level: 'warn', category: 'stream', enabledCategories: enabled }));
-    t.true(shouldLogForCategory({ level: 'error', category: 'stream', enabledCategories: enabled }));
-    t.false(shouldLogForCategory({ level: 'info', category: 'stream', enabledCategories: enabled }));
-});
-test('shouldIncludeVerbosePayload keeps payload only for error unless verbose', (t) => {
-    t.false(shouldIncludeVerbosePayload({ level: 'info', verbosePayloads: false }));
-    t.true(shouldIncludeVerbosePayload({ level: 'error', verbosePayloads: false }));
-    t.true(shouldIncludeVerbosePayload({ level: 'info', verbosePayloads: true }));
-});
-test('shouldSampleLog respects sample rate but never drops errors', (t) => {
-    t.false(shouldSampleLog({ level: 'debug', sampleRate: 0.2, randomValue: 0.9 }));
-    t.true(shouldSampleLog({ level: 'debug', sampleRate: 0.2, randomValue: 0.1 }));
-    t.true(shouldSampleLog({ level: 'error', sampleRate: 0, randomValue: 0.99 }));
-});
-test('resolveLogCategory infers category from event type prefix', (t) => {
-    t.is(resolveLogCategory({ eventType: 'retry.hallucination' }), 'retry');
-    t.is(resolveLogCategory({ eventType: 'tool_call.validation_failed' }), 'tool');
-    t.is(resolveLogCategory({ eventType: 'approval.required' }), 'approval');
-    t.is(resolveLogCategory({ eventType: 'something.else' }), 'general');
-});
-test('createInvalidToolCallDiagnostic returns a complete packet', (t) => {
-    const diagnostic = createInvalidToolCallDiagnostic({
-        toolName: 'shell',
-        toolCallId: 'call-7',
-        rawPayload: '{"command":',
-        normalizedToolCall: { toolName: 'shell', toolCallId: 'call-7' },
-        validationErrors: ['arguments must be valid JSON'],
-        traceId: 'trace-1',
-        retryContext: { hallucinationRetryCount: 1 },
-    });
-    t.is(diagnostic.eventType, 'tool_call.parse_failed');
-    t.is(diagnostic.errorCode, 'INVALID_TOOL_CALL_FORMAT');
-    t.deepEqual(diagnostic.validationErrors, ['arguments must be valid JSON']);
-    t.true(typeof diagnostic.rawPayloadSnippet === 'string');
-});
-//# sourceMappingURL=logging-contract.test.js.map

package/dist/services/logging-contract.test.js.map

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

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

@@ -1,84 +0,0 @@
-interface LoggingServiceConfig {
-    logDir?: string;
-    logLevel?: string;
-    disableLogging?: boolean;
-    console?: boolean;
-    debugLogging?: boolean;
-    suppressConsoleOutput?: boolean;
-}
-/**
- * Winston-based logging service for development, debugging, and security auditing.
- *
- * Features:
- * - Custom log levels (error, warn, security, info, debug)
- * - JSON-formatted file output with daily rotation
- * - XDG-compliant log directories
- * - Correlation ID tracking for request flows
- * - Graceful degradation on write failures
- * - Optional console output for development
- */
-export declare class LoggingService {
-    #private;
-    private logger;
-    private correlationId;
-    private debugLogging;
-    private suppressConsoleOutput;
-    private providerTrafficDir;
-    private evaluatorTrafficDir;
-    private enabledCategories;
-    private verbosePayloads;
-    private sampleRate;
-    private providerTrafficStore;
-    constructor(config?: LoggingServiceConfig);
-    /**
-     * Return the current effective log level for the logger
-     */
-    getLogLevel(): string;
-    setSuppressConsoleOutput(value: boolean): void;
-    /**
-     * Set the current log level at runtime; updates logger and all transports
-     */
-    setLogLevel(level: string): void;
-    /**
-     * Log error-level message
-     */
-    error(message: string, meta?: Record<string, any>): void;
-    /**
-     * Log warn-level message
-     */
-    warn(message: string, meta?: Record<string, any>): void;
-    /**
-     * Log info-level message
-     */
-    info(message: string, meta?: Record<string, any>): void;
-    /**
-     * Log security event (custom level)
-     */
-    security(message: string, meta?: Record<string, any>): void;
-    /**
-     * Log debug-level message
-     */
-    debug(message: string, meta?: Record<string, any>): void;
-    /**
-     * Set correlation ID for tracking related operations
-     */
-    setCorrelationId(id: string): void;
-    /**
-     * Clear correlation ID
-     */
-    clearCorrelationId(): void;
-    /**
-     * Get correlation ID
-     */
-    getCorrelationId(): string | undefined;
-    /**
-     * Remove provider and evaluator traffic logs older than maxFiles (default 30d)
-     */
-    private cleanupProviderTraffic;
-    private cleanupTrafficDir;
-    private log;
-    private writeProviderTrafficArtifact;
-    private emitConsoleError;
-}
-export {};
-//# sourceMappingURL=logging-service.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"logging-service.d.ts","sourceRoot":"","sources":["../../source/services/logging-service.ts"],"names":[],"mappings":"AAkCA,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;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;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAK9B,OAAO,CAAC,iBAAiB;IA8CzB,OAAO,CAAC,GAAG;IAuEX,OAAO,CAAC,4BAA4B;IA8FpC,OAAO,CAAC,gBAAgB;CAMzB"}