@qduc/term2 0.1.4 → 0.1.6

package/dist/services/history-service.js

@@ -14,8 +14,7 @@ export class HistoryService {
     loggingService;
     constructor(deps) {
         this.loggingService = deps.loggingService;
-        this.historyFile =
-            deps.historyFile || path.join(paths.log, 'history.json');
+        this.historyFile = deps.historyFile || path.join(paths.log, 'history.json');
         this.maxHistorySize = deps.settingsService.get('ui.historySize');
         this.load();
     }
@@ -27,9 +26,7 @@ export class HistoryService {
             if (fs.existsSync(this.historyFile)) {
                 const data = fs.readFileSync(this.historyFile, 'utf-8');
                 const parsed = JSON.parse(data);
-                this.messages = Array.isArray(parsed.messages)
-                    ? parsed.messages
-                    : [];
+                this.messages = Array.isArray(parsed.messages) ? parsed.messages : [];
             }
         }
         catch (error) {
@@ -73,8 +70,7 @@ export class HistoryService {
             return;
         }
         // Remove duplicates (if the same message is already the most recent)
-        if (this.messages.length > 0 &&
-            this.messages[this.messages.length - 1] === message) {
+        if (this.messages.length > 0 && this.messages[this.messages.length - 1] === message) {
             return;
         }
         this.messages.push(message);

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

@@ -1 +1 @@
-{"version":3,"file":"history-service.js","sourceRoot":"","sources":["../../source/services/history-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,QAAQ,MAAM,WAAW,CAAC;AACjC,OAAO,EAAC,cAAc,EAAC,MAAM,sBAAsB,CAAC;AAGpD,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;AAMhC;;;GAGG;AACH,MAAM,OAAO,cAAc;IACf,QAAQ,GAAa,EAAE,CAAC;IACxB,WAAW,CAAS;IACpB,cAAc,CAAS;IACvB,cAAc,CAAiB;IAEvC,YAAY,IAIX;QACG,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;QAC1C,IAAI,CAAC,WAAW;YACZ,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QAC7D,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QACjE,IAAI,CAAC,IAAI,EAAE,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,IAAI;QACR,IAAI,CAAC;YACD,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;gBAClC,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;gBACxD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAgB,CAAC;gBAC/C,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;oBAC1C,CAAC,CAAC,MAAM,CAAC,QAAQ;oBACjB,CAAC,CAAC,EAAE,CAAC;YACb,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,mDAAmD;YACnD,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,wBAAwB,EAAE;gBAChD,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;gBAC7D,QAAQ,EAAE,IAAI,CAAC,WAAW;aAC7B,CAAC,CAAC;YACH,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QACvB,CAAC;IACL,CAAC;IAED;;OAEG;IACK,IAAI;QACR,IAAI,CAAC;YACD,0BAA0B;YAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC3C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACtB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAC,SAAS,EAAE,IAAI,EAAC,CAAC,CAAC;YACzC,CAAC;YAED,MAAM,IAAI,GAAgB;gBACtB,QAAQ,EAAE,IAAI,CAAC,QAAQ;aAC1B,CAAC;YAEF,EAAE,CAAC,aAAa,CACZ,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAC7B,OAAO,CACV,CAAC;QACN,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,wBAAwB,EAAE;gBAChD,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;gBAC7D,QAAQ,EAAE,IAAI,CAAC,WAAW;gBAC1B,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM;aACrC,CAAC,CAAC;QACP,CAAC;IACL,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,OAAe;QACtB,wCAAwC;QACxC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YAClB,OAAO;QACX,CAAC;QAED,qEAAqE;QACrE,IACI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;YACxB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,OAAO,EACrD,CAAC;YACC,OAAO;QACX,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAE5B,sCAAsC;QACtC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;YAC7C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC9D,CAAC;QAED,IAAI,CAAC,IAAI,EAAE,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,WAAW;QACP,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,KAAK;QACD,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QACnB,IAAI,CAAC,IAAI,EAAE,CAAC;IAChB,CAAC;CACJ;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,uBAAuB,GAAG,IAAI,cAAc,CAAC;IAC/C,cAAc,EAAE,IAAI,cAAc,CAAC,EAAC,cAAc,EAAE,KAAK,EAAC,CAAC;IAC3D,eAAe,EAAE,IAAI,CAAC,MAAM,mBAAmB;QAC3C,GAAG;YACC,OAAO,IAAI,CAAC;QAChB,CAAC,CAAC,uBAAuB;KAC5B,CAAC,EAAS;CACd,CAAC,CAAC;AAEH,MAAM,iBAAiB,GAAG,GAAG,EAAE;IAC3B,OAAO,CACH,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM;QAC/B,OAAO,CAAC,GAAG,CAAC,MAAM,KAAK,SAAS;QAChC,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,SAAS;QAClC,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,SAAS;QACxC,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,MAAM,CACzC,CAAC;AACN,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,KAAK,CAAC,uBAAuB,EAAE;IAC7D,GAAG,CAAC,MAAM,EAAE,IAAI;QACZ,+DAA+D;QAC/D,IAAI,iBAAiB,EAAE,EAAE,CAAC;YACtB,MAAM,KAAK,GAAG,MAAM,CAAC,IAA2B,CAAC,CAAC;YAClD,iEAAiE;YACjE,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;gBAC9B,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC9B,CAAC;YACD,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,qEAAqE;QACrE,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;QACtC,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,kBAAkB,CAAC;QAE9D,MAAM,IAAI,KAAK,CACX,sEAAsE;YAClE,gBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM;YACvC,0DAA0D;YAC1D,qDAAqD;YACrD,kEAAkE;YAClE,iEAAiE;YACjE,+EAA+E,CACtF,CAAC;IACN,CAAC;CACJ,CAAC,CAAC"}
+{"version":3,"file":"history-service.js","sourceRoot":"","sources":["../../source/services/history-service.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,74 @@
+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";
+        approval: "approval";
+        normalization: "normalization";
+        validation: "validation";
+        execution: "execution";
+        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<{
+        tool: "tool";
+        stream: "stream";
+        retry: "retry";
+        provider: "provider";
+        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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,157 @@
+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

@@ -0,0 +1 @@
+{"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

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

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,66 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -24,6 +24,10 @@ export declare class LoggingService {
     private debugLogging;
     private suppressConsoleOutput;
     private openrouterLogger;
+    private providerTrafficDir;
+    private enabledCategories;
+    private verbosePayloads;
+    private sampleRate;
     constructor(config?: LoggingServiceConfig);
     /**
      * Return the current effective log level for the logger
@@ -68,6 +72,7 @@ export declare class LoggingService {
      */
     getCorrelationId(): string | undefined;
     private log;
+    private writeProviderTrafficArtifact;
     private emitConsoleError;
 }
 export declare const loggingService: LoggingService;

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":"AAuBA,UAAU,oBAAoB;IAC1B,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;CACnC;AAED;;;;;;;;;;GAUG;AACH,qBAAa,cAAc;;IACvB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,qBAAqB,CAAU;IACvC,OAAO,CAAC,gBAAgB,CAAkB;gBAE9B,MAAM,GAAE,oBAAyB;IAsK7C;;OAEG;IACH,WAAW,IAAI,MAAM;IAQrB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAI9C;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAsChC;;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,eAAe,CACX,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC3B,IAAI;IAcP;;OAEG;IACH,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIlC;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAI1B;;OAEG;IACH,gBAAgB,IAAI,MAAM,GAAG,SAAS;IAItC,OAAO,CAAC,GAAG;IA+BX,OAAO,CAAC,gBAAgB;CAM3B;AAgCD,eAAO,MAAM,cAAc,gBAyBzB,CAAC"}
+{"version":3,"file":"logging-service.d.ts","sourceRoot":"","sources":["../../source/services/logging-service.ts"],"names":[],"mappings":"AAiCA,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,gBAAgB,CAAkB;IAC1C,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,iBAAiB,CAA0B;IACnD,OAAO,CAAC,eAAe,CAAU;IACjC,OAAO,CAAC,UAAU,CAAS;gBAEf,MAAM,GAAE,oBAAyB;IAmJ7C;;OAEG;IACH,WAAW,IAAI,MAAM;IAQrB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAI9C;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAgChC;;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,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAYjF;;OAEG;IACH,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIlC;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAI1B;;OAEG;IACH,gBAAgB,IAAI,MAAM,GAAG,SAAS;IAItC,OAAO,CAAC,GAAG;IAkDX,OAAO,CAAC,4BAA4B;IAyDpC,OAAO,CAAC,gBAAgB;CAMzB;AA8BD,eAAO,MAAM,cAAc,gBAyBzB,CAAC"}

package/dist/services/logging-service.js

@@ -3,6 +3,8 @@ import * as path from 'node:path';
 import * as fs from 'node:fs';
 import envPaths from 'env-paths';
 import DailyRotateFile from 'winston-daily-rotate-file';
+import { RuntimeLogSchema, buildRuntimeLogRecord, parseCategoryFilter, shouldIncludeVerbosePayload, shouldLogForCategory, shouldSampleLog, } from './logging-contract.js';
+import { extractProviderTrafficRecordFromRuntimeLog } from '../utils/provider-traffic-extractor.js';
 const LOG_LEVELS = {
     error: 0,
     warn: 1,
@@ -34,15 +36,24 @@ export class LoggingService {
     debugLogging;
     suppressConsoleOutput;
     openrouterLogger;
+    providerTrafficDir;
+    enabledCategories;
+    verbosePayloads;
+    sampleRate;
     constructor(config = {}) {
-        const { logDir, logLevel = 'info', disableLogging, console: enableConsole = false, debugLogging = false, suppressConsoleOutput = true, } = config;
-        const resolvedDisableLogging = disableLogging ??
-            (parseBooleanEnv(process.env.DISABLE_LOGGING) ||
-                Boolean(process.env.AVA));
+        const { logDir, logLevel = process.env.LOG_LEVEL || 'info', disableLogging, console: enableConsole = false, debugLogging = false, suppressConsoleOutput = true, } = config;
+        const resolvedDisableLogging = disableLogging ?? (parseBooleanEnv(process.env.DISABLE_LOGGING) || Boolean(process.env.AVA));
         this.debugLogging = debugLogging;
         this.suppressConsoleOutput = suppressConsoleOutput;
+        this.enabledCategories = parseCategoryFilter(process.env.LOG_CATEGORIES);
+        this.verbosePayloads = parseBooleanEnv(process.env.LOG_VERBOSE_PAYLOADS);
+        this.sampleRate = Number.parseFloat(process.env.LOG_SAMPLE_RATE ?? '1');
+        if (!Number.isFinite(this.sampleRate)) {
+            this.sampleRate = 1;
+        }
         // Determine log directory
         const finalLogDir = logDir || path.join(envPaths('term2').log, 'logs');
+        this.providerTrafficDir = path.join(finalLogDir, 'provider-traffic');
         // Create log directory if needed and logging is enabled
         if (!resolvedDisableLogging) {
             try {
@@ -91,12 +102,10 @@ export class LoggingService {
             levels: LOG_LEVELS,
             format: winston.format.combine(winston.format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }), winston.format.json()),
             defaultMeta: {},
-            transports: transports.length > 0
-                ? transports
-                : [new winston.transports.Console({ silent: true })], // Fallback silent console
+            transports: transports.length > 0 ? transports : [new winston.transports.Console({ silent: true })], // Fallback silent console
         });
         // Add custom log levels to logger if they don't exist
-        Object.keys(LOG_LEVELS).forEach(level => {
+        Object.keys(LOG_LEVELS).forEach((level) => {
             if (typeof this.logger[level] !== 'function') {
                 this.logger[level] = (message, meta) => {
                     this.logger.log(level, message, meta);
@@ -127,9 +136,8 @@ export class LoggingService {
                     transports: [openrouterTransport],
                 });
                 // Add custom log levels
-                Object.keys(LOG_LEVELS).forEach(level => {
-                    if (typeof this.openrouterLogger[level] !==
-                        'function') {
+                Object.keys(LOG_LEVELS).forEach((level) => {
+                    if (typeof this.openrouterLogger[level] !== 'function') {
                         this.openrouterLogger[level] = (message, meta) => {
                             this.openrouterLogger.log(level, message, meta);
                         };
@@ -143,9 +151,7 @@ export class LoggingService {
                 // Fallback
                 this.openrouterLogger = winston.createLogger({
                     levels: LOG_LEVELS,
-                    transports: [
-                        new winston.transports.Console({ silent: true }),
-                    ],
+                    transports: [new winston.transports.Console({ silent: true })],
                 });
             }
         }
@@ -267,15 +273,36 @@ export class LoggingService {
     log(level, message, meta) {
         try {
             const metadata = {
-                ...meta,
+                ...(meta ?? {}),
                 ...(this.correlationId && { correlationId: this.correlationId }),
             };
-            if (this.logger &&
-                typeof this.logger[level] === 'function') {
-                this.logger[level](message, metadata);
+            const runtimeRecord = buildRuntimeLogRecord({
+                level,
+                correlationId: this.correlationId,
+                meta: metadata,
+            });
+            this.writeProviderTrafficArtifact(runtimeRecord, message);
+            const category = runtimeRecord.category ?? 'general';
+            if (!shouldLogForCategory({ level, category, enabledCategories: this.enabledCategories })) {
+                return;
+            }
+            if (!shouldSampleLog({ level, sampleRate: this.sampleRate, randomValue: Math.random() })) {
+                return;
+            }
+            if (!shouldIncludeVerbosePayload({ level, verbosePayloads: this.verbosePayloads })) {
+                delete runtimeRecord.payload;
+            }
+            const parsed = RuntimeLogSchema.safeParse(runtimeRecord);
+            if (!parsed.success) {
+                runtimeRecord.eventType = 'log.contract_validation_failed';
+                runtimeRecord.errorCode = 'LOG_SCHEMA_VALIDATION_FAILED';
+                runtimeRecord.errorMessage = parsed.error.issues.map((issue) => issue.message).join('; ');
+            }
+            if (this.logger && typeof this.logger[level] === 'function') {
+                this.logger[level](message, runtimeRecord);
             }
             else if (this.logger) {
-                this.logger.log(level, message, metadata);
+                this.logger.log(level, message, runtimeRecord);
             }
         }
         catch (error) {
@@ -286,6 +313,52 @@ export class LoggingService {
     #log(level, message, meta) {
         this.log(level, message, meta);
     }
+    writeProviderTrafficArtifact(runtimeRecord, message) {
+        const trafficRecord = extractProviderTrafficRecordFromRuntimeLog({
+            ...runtimeRecord,
+            message,
+        });
+        if (!trafficRecord) {
+            return;
+        }
+        const sanitizeFilePart = (value) => value.replace(/[^a-zA-Z0-9._-]/g, '_');
+        const dateKey = (() => {
+            const timestamp = String(trafficRecord.timestamp ?? '');
+            const matched = timestamp.match(/^(\d{4}-\d{2}-\d{2})/);
+            if (matched?.[1]) {
+                return matched[1];
+            }
+            return new Date().toISOString().slice(0, 10);
+        })();
+        const timestampKey = sanitizeFilePart(String(trafficRecord.timestamp || new Date().toISOString()).replace(/\s+/g, 'T'));
+        const traceKey = sanitizeFilePart(trafficRecord.traceId);
+        const messageId = sanitizeFilePart(String(runtimeRecord.messageId ?? `msg-${Date.now()}`));
+        const traceDir = path.join(this.providerTrafficDir, dateKey, traceKey);
+        const fileName = `${timestampKey}-${messageId}-${trafficRecord.direction}.json`;
+        const filePath = path.join(traceDir, fileName);
+        const artifact = {
+            ...trafficRecord,
+            eventType: runtimeRecord.eventType,
+            messageId: runtimeRecord.messageId,
+            file: path.join(traceKey, fileName),
+        };
+        try {
+            fs.mkdirSync(traceDir, { recursive: true });
+            fs.writeFileSync(filePath, `${JSON.stringify(artifact, null, 2)}\n`, 'utf8');
+            const indexPath = path.join(this.providerTrafficDir, dateKey, 'index.ndjson');
+            fs.appendFileSync(indexPath, `${JSON.stringify({
+                traceId: trafficRecord.traceId,
+                timestamp: trafficRecord.timestamp,
+                direction: trafficRecord.direction,
+                eventType: runtimeRecord.eventType,
+                messageId: runtimeRecord.messageId,
+                file: path.join(traceKey, fileName),
+            })}\n`, 'utf8');
+        }
+        catch (error) {
+            this.emitConsoleError(`[LoggingService] Failed to write provider traffic artifact: ${error.message}`);
+        }
+    }
     emitConsoleError(message) {
         if (!this.debugLogging || this.suppressConsoleOutput) {
             return;
@@ -314,8 +387,7 @@ const isTestEnvironment = () => {
  * It's only allowed in test files for backwards compatibility.
  */
 const _loggingServiceInstance = new LoggingService({
-    disableLogging: parseBooleanEnv(process.env.DISABLE_LOGGING) ||
-        Boolean(process.env.AVA),
+    disableLogging: parseBooleanEnv(process.env.DISABLE_LOGGING) || Boolean(process.env.AVA),
     debugLogging: parseBooleanEnv(process.env.DEBUG_LOGGING),
 });
 export const loggingService = new Proxy(_loggingServiceInstance, {