@qduc/term2 0.7.2 → 0.8.0

package/dist/services/logging/conversation-logger.test.js

@@ -0,0 +1,387 @@
+import { it, expect } from 'vitest';
+import { ConversationLogger } from './conversation-logger.js';
+import { TurnItemAccumulator } from '../session/turn-item-accumulator.js';
+const makeLoggingService = () => {
+    const warnings = [];
+    return {
+        warnings,
+        logger: {
+            info: () => undefined,
+            warn: (message, meta) => warnings.push({ message, meta }),
+            error: () => undefined,
+            debug: () => undefined,
+            security: () => undefined,
+            setCorrelationId: () => undefined,
+            getCorrelationId: () => undefined,
+            clearCorrelationId: () => undefined,
+        },
+    };
+};
+it('setLogSink updates the sink used by log', () => {
+    const { logger } = makeLoggingService();
+    const sinkA = [];
+    const sinkB = [];
+    const conversationLogger = new ConversationLogger({
+        turnAccumulator: new TurnItemAccumulator(),
+        logger,
+        getAssistantTurnState: () => ({ previousResponseId: null }),
+    });
+    conversationLogger.setLogSink((event) => sinkA.push(event));
+    conversationLogger.log({ type: 'session_cleared' });
+    conversationLogger.setLogSink((event) => sinkB.push(event));
+    conversationLogger.log({
+        type: 'undo',
+        removedUserTurns: 1,
+        snapshot: { history: [], previousResponseId: null, toolLedger: [] },
+    });
+    expect(sinkA).toEqual([{ type: 'session_cleared' }]);
+    expect(sinkB).toEqual([
+        { type: 'undo', removedUserTurns: 1, snapshot: { history: [], previousResponseId: null, toolLedger: [] } },
+    ]);
+});
+it('log is a no-op when the sink is null', () => {
+    const { logger, warnings } = makeLoggingService();
+    const conversationLogger = new ConversationLogger({
+        turnAccumulator: new TurnItemAccumulator(),
+        logger,
+        getAssistantTurnState: () => ({ previousResponseId: null }),
+    });
+    conversationLogger.log({ type: 'session_cleared' });
+    expect(warnings.length).toBe(0);
+});
+it('log warns when the sink throws', () => {
+    const { logger, warnings } = makeLoggingService();
+    const conversationLogger = new ConversationLogger({
+        turnAccumulator: new TurnItemAccumulator(),
+        logger,
+        getAssistantTurnState: () => ({ previousResponseId: null }),
+    });
+    conversationLogger.setLogSink(() => {
+        throw new Error('boom');
+    });
+    conversationLogger.log({ type: 'session_cleared' });
+    expect(warnings.length).toBe(1);
+    expect(warnings[0].message).toBe('Conversation log sink threw');
+    expect(warnings[0].meta).toEqual({
+        eventType: 'conversation_log.sink_failed',
+        category: 'persistence',
+        errorMessage: 'boom',
+    });
+});
+it('log stamps the current turn id on operational events', () => {
+    const { logger } = makeLoggingService();
+    const sinkEvents = [];
+    const conversationLogger = new ConversationLogger({
+        turnAccumulator: new TurnItemAccumulator(),
+        logger,
+        getAssistantTurnState: () => ({ previousResponseId: null }),
+        getCurrentTurnId: () => 'turn-9',
+    });
+    conversationLogger.setLogSink((event) => sinkEvents.push(event));
+    conversationLogger.log({
+        type: 'tool_started',
+        toolCallId: 'call-1',
+        toolName: 'shell',
+        arguments: { command: 'pwd' },
+    });
+    conversationLogger.log({
+        type: 'tool_result',
+        callId: 'call-1',
+        toolName: 'shell',
+        status: 'completed',
+        output: 'ok',
+    });
+    conversationLogger.log({
+        type: 'approval_required',
+        approval: { toolName: 'shell', argumentsText: 'pwd', agentName: 'assistant', callId: 'call-1' },
+    });
+    conversationLogger.log({
+        type: 'approval_resolved',
+        answer: 'y',
+    });
+    conversationLogger.log({
+        type: 'assistant_turn',
+        turn: { items: [] },
+        state: { previousResponseId: null },
+    });
+    expect(sinkEvents.map((event) => event.turnId)).toEqual(['turn-9', 'turn-9', 'turn-9', 'turn-9', 'turn-9']);
+});
+it('dispatchEventToLog accumulates turn items and logs the final assistant turn', () => {
+    const { logger, warnings } = makeLoggingService();
+    const sinkEvents = [];
+    const turnAccumulator = new TurnItemAccumulator();
+    const conversationLogger = new ConversationLogger({
+        turnAccumulator,
+        logger,
+        getAssistantTurnState: () => ({
+            previousResponseId: 'resp-1',
+            model: 'gpt-4.1',
+            provider: 'openai',
+        }),
+    });
+    conversationLogger.setLogSink((event) => sinkEvents.push(event));
+    conversationLogger.dispatchEventToLog({ type: 'reasoning_delta', delta: 'thinking' });
+    conversationLogger.dispatchEventToLog({ type: 'text_delta', delta: 'hello' });
+    conversationLogger.dispatchEventToLog({
+        type: 'usage_update',
+        usage: { prompt_tokens: 10, completion_tokens: 4, total_tokens: 14 },
+    });
+    conversationLogger.dispatchEventToLog({
+        type: 'final',
+        finalText: 'ignored because text already exists',
+        usage: { prompt_tokens: 10, completion_tokens: 4, total_tokens: 14 },
+    });
+    expect(warnings.length).toBe(0);
+    expect(sinkEvents).toEqual([
+        {
+            type: 'assistant_turn',
+            turn: {
+                items: [
+                    { type: 'reasoning', text: 'thinking' },
+                    { type: 'assistant_text', text: 'hello' },
+                ],
+            },
+            usage: { prompt_tokens: 10, completion_tokens: 4, total_tokens: 14 },
+            displayUsage: { prompt_tokens: 10, completion_tokens: 4, total_tokens: 14 },
+            state: { previousResponseId: 'resp-1', model: 'gpt-4.1', provider: 'openai' },
+        },
+    ]);
+});
+it('dispatchEventToLog checkpoints accumulated turn items before logging an error', () => {
+    const { logger } = makeLoggingService();
+    const sinkEvents = [];
+    const turnAccumulator = new TurnItemAccumulator();
+    const conversationLogger = new ConversationLogger({
+        turnAccumulator,
+        logger,
+        getAssistantTurnState: () => ({
+            previousResponseId: 'resp-stale',
+            model: 'gpt-5',
+            provider: 'openai',
+        }),
+    });
+    conversationLogger.setLogSink((event) => sinkEvents.push(event));
+    conversationLogger.dispatchEventToLog({ type: 'reasoning_delta', delta: 'inspect' });
+    conversationLogger.dispatchEventToLog({
+        type: 'tool_started',
+        toolCallId: 'call-1',
+        toolName: 'shell',
+        arguments: { command: 'pwd' },
+    });
+    conversationLogger.dispatchEventToLog({
+        type: 'command_message',
+        message: {
+            id: 'msg-1',
+            sender: 'command',
+            status: 'completed',
+            command: 'pwd',
+            output: '/workspace',
+            callId: 'call-1',
+            toolName: 'shell',
+        },
+    });
+    conversationLogger.dispatchEventToLog({ type: 'text_delta', delta: 'continuing' });
+    conversationLogger.dispatchEventToLog({
+        type: 'error',
+        message: 'network timed out',
+        kind: 'network',
+    });
+    expect(sinkEvents).toEqual([
+        { type: 'tool_started', toolCallId: 'call-1', toolName: 'shell', arguments: { command: 'pwd' } },
+        {
+            type: 'command_message',
+            message: {
+                id: 'msg-1',
+                sender: 'command',
+                status: 'completed',
+                command: 'pwd',
+                output: '/workspace',
+                callId: 'call-1',
+                toolName: 'shell',
+            },
+        },
+        {
+            type: 'assistant_turn',
+            turn: {
+                items: [
+                    { type: 'reasoning', text: 'inspect' },
+                    { type: 'tool_call', callId: 'call-1', toolName: 'shell', arguments: { command: 'pwd' } },
+                    { type: 'tool_result', callId: 'call-1', toolName: 'shell', status: 'completed', output: '/workspace' },
+                    { type: 'assistant_text', text: 'continuing' },
+                ],
+            },
+            state: { previousResponseId: null, model: 'gpt-5', provider: 'openai' },
+        },
+        { type: 'error', message: 'network timed out', kind: 'network' },
+    ]);
+    expect(turnAccumulator.getTurnItems()).toEqual([]);
+});
+it('dispatchEventToLog logs event-specific records', () => {
+    const { logger } = makeLoggingService();
+    const sinkEvents = [];
+    const turnAccumulator = new TurnItemAccumulator();
+    const conversationLogger = new ConversationLogger({
+        turnAccumulator,
+        logger,
+        getAssistantTurnState: () => ({ previousResponseId: null }),
+    });
+    conversationLogger.setLogSink((event) => sinkEvents.push(event));
+    conversationLogger.dispatchEventToLog({
+        type: 'tool_started',
+        toolCallId: 'call-1',
+        toolName: 'shell',
+        arguments: { command: 'echo hi' },
+    });
+    conversationLogger.dispatchEventToLog({
+        type: 'command_message',
+        message: {
+            id: 'msg-1',
+            sender: 'command',
+            status: 'completed',
+            command: 'echo hi',
+            output: 'hi',
+            callId: 'call-1',
+            toolName: 'shell',
+        },
+    });
+    conversationLogger.dispatchEventToLog({
+        type: 'approval_required',
+        approval: {
+            toolName: 'shell',
+            argumentsText: 'echo hi',
+            agentName: 'assistant',
+            callId: 'call-1',
+        },
+    });
+    conversationLogger.dispatchEventToLog({
+        type: 'subagent_started',
+        agentId: 'agent-1',
+        role: 'worker',
+        task: 'inspect',
+    });
+    conversationLogger.dispatchEventToLog({
+        type: 'subagent_tool_started',
+        agentId: 'agent-1',
+        role: 'worker',
+        toolCallId: 'nested-call-1',
+        toolName: 'shell',
+        arguments: { command: 'pwd' },
+    });
+    conversationLogger.dispatchEventToLog({
+        type: 'subagent_completed',
+        result: {
+            agentId: 'agent-1',
+            role: 'worker',
+            status: 'completed',
+            finalText: 'done',
+            filesChanged: [],
+            toolsUsed: [],
+        },
+    });
+    conversationLogger.dispatchEventToLog({
+        type: 'error',
+        message: 'something failed',
+        kind: 'runtime',
+        stack: 'stack-trace',
+    });
+    expect(sinkEvents).toEqual([
+        { type: 'tool_started', toolCallId: 'call-1', toolName: 'shell', arguments: { command: 'echo hi' } },
+        {
+            type: 'command_message',
+            message: {
+                id: 'msg-1',
+                sender: 'command',
+                status: 'completed',
+                command: 'echo hi',
+                output: 'hi',
+                callId: 'call-1',
+                toolName: 'shell',
+            },
+        },
+        {
+            type: 'approval_required',
+            approval: { toolName: 'shell', argumentsText: 'echo hi', agentName: 'assistant', callId: 'call-1' },
+        },
+        { type: 'subagent_started', agentId: 'agent-1', role: 'worker', task: 'inspect' },
+        {
+            type: 'subagent_tool_started',
+            agentId: 'agent-1',
+            role: 'worker',
+            toolCallId: 'nested-call-1',
+            toolName: 'shell',
+            arguments: { command: 'pwd' },
+        },
+        {
+            type: 'subagent_completed',
+            result: {
+                agentId: 'agent-1',
+                role: 'worker',
+                status: 'completed',
+                finalText: 'done',
+                filesChanged: [],
+                toolsUsed: [],
+            },
+        },
+        {
+            type: 'assistant_turn',
+            turn: {
+                items: [
+                    { type: 'tool_call', callId: 'call-1', toolName: 'shell', arguments: { command: 'echo hi' } },
+                    { type: 'tool_result', callId: 'call-1', toolName: 'shell', status: 'completed', output: 'hi' },
+                ],
+            },
+            state: { previousResponseId: null },
+        },
+        { type: 'error', message: 'something failed', kind: 'runtime', stack: 'stack-trace' },
+    ]);
+    conversationLogger.dispatchEventToLog({
+        type: 'final',
+        finalText: 'done',
+    });
+    expect(turnAccumulator.getTurnItems()).toEqual([]);
+    expect(sinkEvents.at(-1)).toEqual({
+        type: 'assistant_turn',
+        turn: {
+            items: [{ type: 'assistant_text', text: 'done' }],
+        },
+        state: { previousResponseId: null },
+    });
+});
+it('dispatchEventToLog forwards text and reasoning deltas to the journal', () => {
+    const { logger } = makeLoggingService();
+    const sinkEvents = [];
+    const turnAccumulator = new TurnItemAccumulator();
+    const journalDeltas = [];
+    const conversationLogger = new ConversationLogger({
+        turnAccumulator,
+        logger,
+        getAssistantTurnState: () => ({ previousResponseId: null }),
+        getJournal: () => ({
+            recordTextDelta: (delta) => journalDeltas.push({ kind: 'text', delta }),
+            recordReasoningDelta: (delta) => journalDeltas.push({ kind: 'reasoning', delta }),
+        }),
+    });
+    conversationLogger.setLogSink((event) => sinkEvents.push(event));
+    conversationLogger.dispatchEventToLog({ type: 'reasoning_delta', delta: 'think' });
+    conversationLogger.dispatchEventToLog({ type: 'text_delta', delta: 'hi' });
+    expect(journalDeltas).toEqual([
+        { kind: 'reasoning', delta: 'think' },
+        { kind: 'text', delta: 'hi' },
+    ]);
+});
+it('dispatchEventToLog is a no-op for the journal when no journal is registered', () => {
+    const { logger } = makeLoggingService();
+    const sinkEvents = [];
+    const turnAccumulator = new TurnItemAccumulator();
+    const conversationLogger = new ConversationLogger({
+        turnAccumulator,
+        logger,
+        getAssistantTurnState: () => ({ previousResponseId: null }),
+    });
+    conversationLogger.setLogSink((event) => sinkEvents.push(event));
+    // Should not throw.
+    conversationLogger.dispatchEventToLog({ type: 'reasoning_delta', delta: 'x' });
+    conversationLogger.dispatchEventToLog({ type: 'text_delta', delta: 'y' });
+    expect(sinkEvents).toEqual([]);
+});
+//# sourceMappingURL=conversation-logger.test.js.map

package/dist/services/logging/conversation-logger.test.js.map

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

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

@@ -0,0 +1,55 @@
+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.ZodOptional<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    messageId: z.ZodString;
+    provider: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    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>;
+}, 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/logging-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging-contract.d.ts","sourceRoot":"","sources":["../../../source/services/logging/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;AAE1D,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;iBAkBb,CAAC;AAcjB,eAAO,MAAM,kBAAkB,GAAI,kCAGhC;IACD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,KAAG,WAgBH,CAAC;AAiBF,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,CA6BzB,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,CAazB,CAAC"}

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

@@ -0,0 +1,141 @@
+import { z } from 'zod';
+export const LOG_CATEGORIES = ['provider', 'tool', 'stream', 'approval', 'retry', 'general'];
+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).optional(),
+    sessionId: z.string().min(1).optional(),
+    messageId: z.string().min(1),
+    provider: z.string().min(1).optional(),
+    model: z.string().min(1).optional(),
+    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(),
+})
+    .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 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 eventType = toNonEmptyString(meta.eventType, 'log.message');
+    const rawProvider = toNonEmptyString(meta.provider, 'unknown');
+    const rawModel = toNonEmptyString(meta.model, 'unknown');
+    const rawSessionId = toNonEmptyString(meta.sessionId, 'session-unknown');
+    const rawTraceId = toNonEmptyString(meta.traceId ?? correlationId, 'trace-unknown');
+    const record = {
+        ...meta,
+        timestamp: timestamp ?? new Date().toISOString(),
+        level,
+        eventType,
+        messageId: buildMessageId(meta),
+    };
+    if (rawProvider !== 'unknown')
+        record.provider = rawProvider;
+    if (rawModel !== 'unknown')
+        record.model = rawModel;
+    if (rawSessionId !== 'session-unknown')
+        record.sessionId = rawSessionId;
+    let finalTrace = rawTraceId;
+    if (!looksLikeUuid(rawTraceId) && correlationId && looksLikeUuid(correlationId)) {
+        finalTrace = correlationId;
+    }
+    if (finalTrace !== 'trace-unknown')
+        record.traceId = finalTrace;
+    delete record.category;
+    delete record.phase;
+    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',
+        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/logging-contract.js.map

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

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

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

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

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