@roackb2/heddle 1.5.0 → 1.7.0

package/dist/src/core/observability/activity/conversation-activity-projector.js

@@ -0,0 +1,146 @@
+import { ToolActivitySummarizer } from './tool-activity-summarizer.js';
+/**
+ * Projects raw runtime, trace, and compaction events into host-agnostic
+ * conversation activities. Activities retain their source event and only add
+ * derived fields when this boundary performs real semantic work.
+ */
+export class ConversationActivityProjector {
+    static traceProjectors = {
+        'run.started': (event) => [ConversationActivityProjector.traceActivity(event)],
+        'assistant.turn': (event) => [ConversationActivityProjector.traceActivity(event)],
+        'host.warning': () => [],
+        'tool.approval_requested': (event) => [ConversationActivityProjector.traceActivity(event, {
+                kind: 'tool-summary',
+                summary: ToolActivitySummarizer.summarizeCall(event.call),
+            })],
+        'tool.approval_resolved': (event) => [ConversationActivityProjector.traceActivity(event, {
+                kind: 'tool-summary',
+                summary: ToolActivitySummarizer.summarizeCall(event.call),
+            })],
+        'tool.fallback': (event) => [ConversationActivityProjector.traceActivity(event, {
+                kind: 'tool-fallback-summary',
+                fromSummary: ToolActivitySummarizer.summarizeCall(event.fromCall),
+                toSummary: ToolActivitySummarizer.summarizeCall(event.toCall),
+            })],
+        'tool.call': (event) => [ConversationActivityProjector.traceActivity(event, {
+                kind: 'tool-summary',
+                summary: ToolActivitySummarizer.summarizeCall(event.call),
+            })],
+        'tool.result': (event) => [ConversationActivityProjector.traceActivity(event, {
+                kind: 'tool-summary',
+                summary: ToolActivitySummarizer.summarizeResult(event),
+            })],
+        'memory.candidate_recorded': (event) => [ConversationActivityProjector.traceActivity(event)],
+        'memory.checkpoint_skipped': () => [],
+        'memory.maintenance_started': (event) => [ConversationActivityProjector.traceActivity(event)],
+        'memory.maintenance_finished': (event) => [ConversationActivityProjector.traceActivity(event)],
+        'memory.maintenance_failed': (event) => [ConversationActivityProjector.traceActivity(event)],
+        'cyberloop.annotation': (event) => (event.driftLevel === 'unknown' ? [] : [ConversationActivityProjector.traceActivity(event, {
+                kind: 'cyberloop-metrics',
+                metrics: ConversationActivityProjector.formatCyberLoopMetrics(event.metadata),
+            })]),
+        'run.finished': (event) => [ConversationActivityProjector.traceActivity(event)],
+    };
+    static agentLoopProjectors = {
+        'loop.started': (event) => [ConversationActivityProjector.agentLoopActivity(event)],
+        'assistant.stream': (event) => [ConversationActivityProjector.agentLoopActivity(event)],
+        'tool.calling': (event) => [ConversationActivityProjector.agentLoopActivity(event, {
+                kind: 'tool-summary',
+                summary: ToolActivitySummarizer.summarizeCall(event),
+            })],
+        'tool.completed': (event) => [ConversationActivityProjector.agentLoopActivity(event)],
+        trace: (event) => ConversationActivityProjector.fromTraceEvent(event.event)
+            .map((activity) => activity.source === 'trace' ? {
+            ...activity,
+            correlation: { ...activity.correlation, runId: event.runId },
+        } : activity),
+        'loop.finished': (event) => [ConversationActivityProjector.agentLoopActivity(event)],
+    };
+    static compactionProjectors = {
+        running: (event) => [{ source: 'compaction', type: 'compaction.running', event }],
+        finished: (event) => [{ source: 'compaction', type: 'compaction.finished', event }],
+        failed: (event) => [{ source: 'compaction', type: 'compaction.failed', event }],
+    };
+    static fromTraceEvent(event) {
+        const projector = ConversationActivityProjector.traceProjectors[event.type];
+        return projector(event);
+    }
+    static fromAgentLoopEvent(event) {
+        const projector = ConversationActivityProjector.agentLoopProjectors[event.type];
+        return projector?.(event) ?? [];
+    }
+    static fromCompactionStatus(event) {
+        const projector = ConversationActivityProjector.compactionProjectors[event.status];
+        return projector(event);
+    }
+    static applyHandler(args) {
+        const handler = args.handlers[args.activity.type];
+        return handler?.(args.activity, args.context);
+    }
+    static traceActivity(event, derived) {
+        return {
+            source: 'trace',
+            type: event.type,
+            event,
+            correlation: ConversationActivityProjector.traceCorrelation(event),
+            derived,
+        };
+    }
+    static agentLoopActivity(event, derived) {
+        return {
+            source: 'agent-loop',
+            type: event.type,
+            event,
+            correlation: ConversationActivityProjector.agentLoopCorrelation(event),
+            derived,
+        };
+    }
+    static traceCorrelation(event) {
+        const correlation = { timestamp: event.timestamp };
+        if ('runId' in event) {
+            correlation.runId = event.runId;
+        }
+        if ('step' in event) {
+            correlation.step = event.step;
+        }
+        return correlation;
+    }
+    static agentLoopCorrelation(event) {
+        const correlation = {
+            runId: event.runId,
+            timestamp: event.timestamp,
+        };
+        if ('step' in event) {
+            correlation.step = event.step;
+        }
+        return correlation;
+    }
+    static formatCyberLoopMetrics(metadata) {
+        const kinematics = metadata.kinematics;
+        if (!kinematics || typeof kinematics !== 'object' || Array.isArray(kinematics)) {
+            return '';
+        }
+        const snapshot = kinematics;
+        const parts = [];
+        if (typeof snapshot.errorMagnitude === 'number') {
+            parts.push(`err=${ConversationActivityProjector.formatMetric(snapshot.errorMagnitude)}`);
+        }
+        if (typeof snapshot.correctionMagnitude === 'number') {
+            parts.push(`corr=${ConversationActivityProjector.formatMetric(snapshot.correctionMagnitude)}`);
+        }
+        if (typeof snapshot.isStable === 'boolean') {
+            parts.push(`stable=${snapshot.isStable}`);
+        }
+        return parts.length ? ` (${parts.join(' ')})` : '';
+    }
+    static formatMetric(value) {
+        if (!Number.isFinite(value)) {
+            return String(value);
+        }
+        if (Math.abs(value) < 0.001 && value !== 0) {
+            return value.toExponential(2);
+        }
+        return value.toFixed(3);
+    }
+}
+//# sourceMappingURL=conversation-activity-projector.js.map

package/dist/src/core/observability/activity/conversation-activity-projector.js.map

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

package/dist/src/core/observability/activity/index.d.ts

@@ -0,0 +1,4 @@
+export { ConversationActivityProjector } from './conversation-activity-projector.js';
+export { ToolActivitySummarizer } from './tool-activity-summarizer.js';
+export type { ApplyConversationActivityHandlerArgs, ConversationAgentLoopActivityEvent, ConversationActivity, ConversationActivityCorrelation, ConversationActivityDerived, ConversationActivityHandlerMap, ConversationActivityOf, ConversationCompactionStatus, ToolCallSummaryInput, ToolResultSummaryOptions, ToolSummaryOptions, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/observability/activity/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/observability/activity/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,sCAAsC,CAAC;AACrF,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,YAAY,EACV,oCAAoC,EACpC,kCAAkC,EAClC,oBAAoB,EACpB,+BAA+B,EAC/B,2BAA2B,EAC3B,8BAA8B,EAC9B,sBAAsB,EACtB,4BAA4B,EAC5B,oBAAoB,EACpB,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/src/core/observability/activity/index.js

@@ -0,0 +1,3 @@
+export { ConversationActivityProjector } from './conversation-activity-projector.js';
+export { ToolActivitySummarizer } from './tool-activity-summarizer.js';
+//# sourceMappingURL=index.js.map

package/dist/src/core/observability/activity/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/observability/activity/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,sCAAsC,CAAC;AACrF,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/src/core/observability/activity/tool-activity-summarizer.d.ts

@@ -0,0 +1,15 @@
+import type { ToolCallSummaryInput, ToolResultSummaryOptions, ToolSummaryOptions } from './types.js';
+/**
+ * Builds compact tool call/result labels for live activity and durable trace
+ * summaries. It owns presentation-safe summarization, not tool execution.
+ */
+export declare class ToolActivitySummarizer {
+    static summarizeCall(call: ToolCallSummaryInput, options?: ToolSummaryOptions): string;
+    static summarizeResult(options: ToolResultSummaryOptions): string;
+    private static summarizeMoveInput;
+    private static summarizeSearchInput;
+    private static summarizePlanInput;
+    private static getPlanItemStep;
+    private static readStringField;
+}
+//# sourceMappingURL=tool-activity-summarizer.d.ts.map

package/dist/src/core/observability/activity/tool-activity-summarizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-activity-summarizer.d.ts","sourceRoot":"","sources":["../../../../../src/core/observability/activity/tool-activity-summarizer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAIrG;;;GAGG;AACH,qBAAa,sBAAsB;IACjC,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,oBAAoB,EAAE,OAAO,GAAE,kBAAuB,GAAG,MAAM;IAwB1F,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,wBAAwB,GAAG,MAAM;IAoBjE,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAWjC,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAcnC,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAgBjC,OAAO,CAAC,MAAM,CAAC,eAAe;IAS9B,OAAO,CAAC,MAAM,CAAC,eAAe;CAQ/B"}

package/dist/src/core/observability/activity/tool-activity-summarizer.js

@@ -0,0 +1,92 @@
+import { truncate } from '../../../core/utils/text.js';
+const DEFAULT_MAX_TOOL_SUMMARY_CHARS = 96;
+/**
+ * Builds compact tool call/result labels for live activity and durable trace
+ * summaries. It owns presentation-safe summarization, not tool execution.
+ */
+export class ToolActivitySummarizer {
+    static summarizeCall(call, options = {}) {
+        const maxChars = options.maxChars ?? DEFAULT_MAX_TOOL_SUMMARY_CHARS;
+        if (call.tool === 'update_plan') {
+            return ToolActivitySummarizer.summarizePlanInput(call.tool, call.input, maxChars);
+        }
+        const command = ToolActivitySummarizer.readStringField(call.input, 'command');
+        if (command) {
+            return `${call.tool} (${truncate(command, maxChars)})`;
+        }
+        if (call.tool === 'search_files') {
+            return ToolActivitySummarizer.summarizeSearchInput(call.tool, call.input, maxChars);
+        }
+        const moveSummary = ToolActivitySummarizer.summarizeMoveInput(call.tool, call.input, maxChars);
+        if (moveSummary) {
+            return moveSummary;
+        }
+        const path = ToolActivitySummarizer.readStringField(call.input, 'path');
+        return path ? `${call.tool} (${truncate(path, maxChars)})` : call.tool;
+    }
+    static summarizeResult(options) {
+        const maxChars = options.maxChars ?? DEFAULT_MAX_TOOL_SUMMARY_CHARS;
+        const command = ToolActivitySummarizer.readStringField(options.result.output, 'command');
+        if (command) {
+            return `${options.tool} (${truncate(command, maxChars)})`;
+        }
+        const moveSummary = ToolActivitySummarizer.summarizeMoveInput(options.tool, options.result.output, maxChars);
+        if (moveSummary) {
+            return moveSummary;
+        }
+        const outputPath = ToolActivitySummarizer.readStringField(options.result.output, 'path');
+        if (outputPath) {
+            return `${options.tool} (${truncate(outputPath, maxChars)})`;
+        }
+        return options.tool;
+    }
+    static summarizeMoveInput(tool, input, maxChars) {
+        const from = ToolActivitySummarizer.readStringField(input, 'from');
+        const to = ToolActivitySummarizer.readStringField(input, 'to');
+        if (!from && !to) {
+            return undefined;
+        }
+        const segmentChars = Math.max(12, Math.floor(maxChars / 2));
+        return `${tool} (${from ? truncate(from, segmentChars) : '?'} -> ${to ? truncate(to, segmentChars) : '?'})`;
+    }
+    static summarizeSearchInput(tool, input, maxChars) {
+        const query = ToolActivitySummarizer.readStringField(input, 'query');
+        if (!query) {
+            return tool;
+        }
+        const path = ToolActivitySummarizer.readStringField(input, 'path');
+        const segmentChars = Math.max(12, Math.floor(maxChars / 2));
+        const querySummary = truncate(JSON.stringify(query), segmentChars);
+        return path ?
+            `${tool} (${querySummary} in ${truncate(path, segmentChars)})`
+            : `${tool} (${querySummary})`;
+    }
+    static summarizePlanInput(tool, input, maxChars) {
+        if (!input || typeof input !== 'object' || Array.isArray(input)) {
+            return tool;
+        }
+        const plan = input.plan;
+        if (!Array.isArray(plan) || plan.length === 0) {
+            return tool;
+        }
+        const currentStep = plan
+            .map((item) => ToolActivitySummarizer.getPlanItemStep(item, 'in_progress'))
+            .find((step) => Boolean(step));
+        return currentStep ? `${tool} (${truncate(currentStep, maxChars)})` : `${tool} (${plan.length} items)`;
+    }
+    static getPlanItemStep(item, status) {
+        if (!item || typeof item !== 'object' || Array.isArray(item)) {
+            return undefined;
+        }
+        const candidate = item;
+        return candidate.status === status && typeof candidate.step === 'string' ? candidate.step : undefined;
+    }
+    static readStringField(value, field) {
+        if (!value || typeof value !== 'object' || Array.isArray(value)) {
+            return undefined;
+        }
+        const candidate = value[field];
+        return typeof candidate === 'string' && candidate.trim() ? candidate.trim() : undefined;
+    }
+}
+//# sourceMappingURL=tool-activity-summarizer.js.map

package/dist/src/core/observability/activity/tool-activity-summarizer.js.map

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

package/dist/src/core/observability/activity/types.d.ts

@@ -0,0 +1,87 @@
+import type { AgentLoopEvent } from '../../../core/runtime/loop/index.js';
+import type { ToolCall, ToolResult, TraceEvent } from '../../../core/types.js';
+export type ConversationActivityCorrelation = {
+    runId?: string;
+    step?: number;
+    timestamp?: string;
+};
+export type ConversationCompactionStatus = {
+    status: 'running';
+    archivePath?: string;
+} | {
+    status: 'finished';
+    summaryPath?: string;
+} | {
+    status: 'failed';
+    error?: string;
+};
+export type ConversationToolSummary = {
+    kind: 'tool-summary';
+    summary: string;
+};
+export type ConversationToolFallbackSummary = {
+    kind: 'tool-fallback-summary';
+    fromSummary: string;
+    toSummary: string;
+};
+export type ConversationCyberLoopMetricsSummary = {
+    kind: 'cyberloop-metrics';
+    metrics: string;
+};
+export type ConversationActivityDerived = ConversationToolSummary | ConversationToolFallbackSummary | ConversationCyberLoopMetricsSummary;
+type TraceActivity = {
+    [Type in TraceEvent['type']]: {
+        source: 'trace';
+        type: Type;
+        event: Extract<TraceEvent, {
+            type: Type;
+        }>;
+        correlation: ConversationActivityCorrelation;
+        derived?: ConversationActivityDerived;
+    };
+}[TraceEvent['type']];
+export type ConversationAgentLoopActivityEvent = Exclude<AgentLoopEvent, {
+    type: 'trace' | 'checkpoint.saved' | 'loop.resumed';
+}>;
+type AgentLoopActivity = {
+    [Type in ConversationAgentLoopActivityEvent['type']]: {
+        source: 'agent-loop';
+        type: Type;
+        event: Extract<ConversationAgentLoopActivityEvent, {
+            type: Type;
+        }>;
+        correlation: ConversationActivityCorrelation;
+        derived?: ConversationActivityDerived;
+    };
+}[ConversationAgentLoopActivityEvent['type']];
+type CompactionActivity = {
+    [Status in ConversationCompactionStatus['status']]: {
+        source: 'compaction';
+        type: `compaction.${Status}`;
+        event: Extract<ConversationCompactionStatus, {
+            status: Status;
+        }>;
+    };
+}[ConversationCompactionStatus['status']];
+export type ConversationActivity = TraceActivity | AgentLoopActivity | CompactionActivity;
+export type ConversationActivityOf<Type extends ConversationActivity['type']> = Extract<ConversationActivity, {
+    type: Type;
+}>;
+export type ConversationActivityHandlerMap<Context, Result = void> = {
+    [Type in ConversationActivity['type']]?: (activity: ConversationActivityOf<Type>, context: Context) => Result;
+};
+export type ApplyConversationActivityHandlerArgs<Context, Result = void> = {
+    activity: ConversationActivity;
+    handlers: ConversationActivityHandlerMap<Context, Result>;
+    context: Context;
+};
+export type ToolSummaryOptions = {
+    maxChars?: number;
+};
+export type ToolResultSummaryOptions = ToolSummaryOptions & {
+    tool: string;
+    result: ToolResult;
+};
+export type ToolCallSummaryInput = Pick<ToolCall, 'tool' | 'input'>;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/src/core/observability/activity/types.d.ts.map

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

package/dist/src/core/observability/activity/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/core/observability/activity/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/core/observability/activity/types.ts"],"names":[],"mappings":""}

package/dist/src/core/observability/index.d.ts

@@ -0,0 +1,6 @@
+export { ConversationActivityProjector, ToolActivitySummarizer } from './activity/index.js';
+export type { ApplyConversationActivityHandlerArgs, ConversationAgentLoopActivityEvent, ConversationActivity, ConversationActivityCorrelation, ConversationActivityDerived, ConversationActivityHandlerMap, ConversationActivityOf, ConversationCompactionStatus, ToolCallSummaryInput, ToolResultSummaryOptions, ToolSummaryOptions, } from './activity/index.js';
+export { DEFAULT_TRACE_SUMMARIZERS, TraceSummaryService } from './summaries/index.js';
+export type { TraceEventOfType, TraceEventType, TraceSummarizer, TraceSummarizerMap, TraceSummaryContext, TraceSummaryValue, } from './summaries/index.js';
+export { TRACE_CORRELATION_FIELDS, TRACE_EVENT_DOMAINS, TRACE_EVENT_TYPES, } from './semantics/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/observability/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/observability/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC5F,YAAY,EACV,oCAAoC,EACpC,kCAAkC,EAClC,oBAAoB,EACpB,+BAA+B,EAC/B,2BAA2B,EAC3B,8BAA8B,EAC9B,sBAAsB,EACtB,4BAA4B,EAC5B,oBAAoB,EACpB,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACtF,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC"}

package/dist/src/core/observability/index.js

@@ -0,0 +1,4 @@
+export { ConversationActivityProjector, ToolActivitySummarizer } from './activity/index.js';
+export { DEFAULT_TRACE_SUMMARIZERS, TraceSummaryService } from './summaries/index.js';
+export { TRACE_CORRELATION_FIELDS, TRACE_EVENT_DOMAINS, TRACE_EVENT_TYPES, } from './semantics/index.js';
+//# sourceMappingURL=index.js.map

package/dist/src/core/observability/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/observability/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAc5F,OAAO,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAStF,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC"}

package/dist/src/core/observability/semantics/index.d.ts

@@ -0,0 +1,2 @@
+export { TRACE_CORRELATION_FIELDS, TRACE_EVENT_DOMAINS, TRACE_EVENT_TYPES, } from './trace-semantics.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/observability/semantics/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/observability/semantics/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC"}

package/dist/src/core/observability/semantics/index.js

@@ -0,0 +1,2 @@
+export { TRACE_CORRELATION_FIELDS, TRACE_EVENT_DOMAINS, TRACE_EVENT_TYPES, } from './trace-semantics.js';
+//# sourceMappingURL=index.js.map

package/dist/src/core/observability/semantics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/observability/semantics/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC"}

package/dist/src/core/observability/{semantic-conventions.d.ts → semantics/trace-semantics.d.ts}

@@ -30,4 +30,4 @@ export declare const TRACE_CORRELATION_FIELDS: {
     readonly step: "step";
     readonly timestamp: "timestamp";
 };
-//# sourceMappingURL=semantic-conventions.d.ts.map
+//# sourceMappingURL=trace-semantics.d.ts.map

package/dist/src/core/observability/semantics/trace-semantics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-semantics.d.ts","sourceRoot":"","sources":["../../../../../src/core/observability/semantics/trace-semantics.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,mBAAmB;;;;;;;CAOtB,CAAC;AAEX,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;CAgByB,CAAC;AAExD,eAAO,MAAM,wBAAwB;;;;;;CAM3B,CAAC"}

package/dist/src/core/observability/{semantic-conventions.js → semantics/trace-semantics.js}

@@ -30,4 +30,4 @@ export const TRACE_CORRELATION_FIELDS = {
     step: 'step',
     timestamp: 'timestamp',
 };
-//# sourceMappingURL=semantic-conventions.js.map
+//# sourceMappingURL=trace-semantics.js.map

package/dist/src/core/observability/semantics/trace-semantics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-semantics.js","sourceRoot":"","sources":["../../../../../src/core/observability/semantics/trace-semantics.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,GAAG,EAAE,KAAK;IACV,SAAS,EAAE,WAAW;IACtB,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,WAAW;CACd,CAAC;AAEX,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,UAAU,EAAE,aAAa;IACzB,WAAW,EAAE,cAAc;IAC3B,aAAa,EAAE,gBAAgB;IAC/B,WAAW,EAAE,cAAc;IAC3B,qBAAqB,EAAE,yBAAyB;IAChD,oBAAoB,EAAE,wBAAwB;IAC9C,YAAY,EAAE,eAAe;IAC7B,QAAQ,EAAE,WAAW;IACrB,UAAU,EAAE,aAAa;IACzB,uBAAuB,EAAE,2BAA2B;IACpD,uBAAuB,EAAE,2BAA2B;IACpD,wBAAwB,EAAE,4BAA4B;IACtD,yBAAyB,EAAE,6BAA6B;IACxD,uBAAuB,EAAE,2BAA2B;IACpD,mBAAmB,EAAE,sBAAsB;CACU,CAAC;AAExD,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,KAAK,EAAE,OAAO;IACd,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;IACZ,SAAS,EAAE,WAAW;CACd,CAAC"}

package/dist/src/core/observability/summaries/default-trace-summarizers.d.ts

@@ -0,0 +1,3 @@
+import type { TraceSummarizerMap } from './types.js';
+export declare const DEFAULT_TRACE_SUMMARIZERS: TraceSummarizerMap;
+//# sourceMappingURL=default-trace-summarizers.d.ts.map

package/dist/src/core/observability/summaries/default-trace-summarizers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-trace-summarizers.d.ts","sourceRoot":"","sources":["../../../../../src/core/observability/summaries/default-trace-summarizers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,eAAO,MAAM,yBAAyB,EAAE,kBAyBvC,CAAC"}

package/dist/src/core/observability/summaries/default-trace-summarizers.js

@@ -0,0 +1,29 @@
+import { truncate } from '../../../core/utils/text.js';
+import { ToolActivitySummarizer } from '../activity/index.js';
+export const DEFAULT_TRACE_SUMMARIZERS = {
+    'run.started': () => undefined,
+    'assistant.turn': (event) => [
+        ...(event.diagnostics?.rationale ? [`reasoning: ${truncate(event.diagnostics.rationale, 140)}`] : []),
+        event.requestedTools ?
+            `assistant requested ${event.toolCalls?.map((call) => ToolActivitySummarizer.summarizeCall(call)).join(', ')}`
+            : 'assistant answered',
+    ],
+    'host.warning': (event) => [`host warning ${event.code}: ${truncate(event.message, 140)}`],
+    'tool.approval_requested': (event) => [`approval requested for ${ToolActivitySummarizer.summarizeCall(event.call)}`],
+    'tool.approval_resolved': (event) => [
+        `approval ${event.approved ? 'granted' : 'denied'} for ${ToolActivitySummarizer.summarizeCall(event.call)}${event.reason ? ` (${truncate(event.reason, 80)})` : ''}`,
+    ],
+    'tool.fallback': (event) => [
+        `fallback ${ToolActivitySummarizer.summarizeCall(event.fromCall)} -> ${ToolActivitySummarizer.summarizeCall(event.toCall)} (${event.reason})`,
+    ],
+    'tool.call': (event) => [`tool call ${ToolActivitySummarizer.summarizeCall(event.call)}`],
+    'tool.result': (event) => [`tool result ${event.tool}: ${event.result.ok ? 'ok' : event.result.error ?? 'error'}`],
+    'memory.candidate_recorded': (event) => [`memory candidate recorded: ${event.candidateId}`],
+    'memory.checkpoint_skipped': (event) => [`memory checkpoint skipped: ${truncate(event.rationale, 100)}`],
+    'memory.maintenance_started': (event) => [`memory maintenance started: ${event.candidateIds.join(', ')}`],
+    'memory.maintenance_finished': (event) => [`memory maintenance finished: ${event.outcome}`],
+    'memory.maintenance_failed': (event) => [`memory maintenance failed: ${event.error}`],
+    'cyberloop.annotation': () => undefined,
+    'run.finished': (event) => [`run finished: ${event.outcome}`],
+};
+//# sourceMappingURL=default-trace-summarizers.js.map

package/dist/src/core/observability/summaries/default-trace-summarizers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-trace-summarizers.js","sourceRoot":"","sources":["../../../../../src/core/observability/summaries/default-trace-summarizers.ts"],"names":[],"mappings":"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"}

package/dist/src/core/observability/summaries/index.d.ts

@@ -0,0 +1,4 @@
+export { DEFAULT_TRACE_SUMMARIZERS } from './default-trace-summarizers.js';
+export { TraceSummaryService } from './trace-summary-service.js';
+export type { TraceEventOfType, TraceEventType, TraceSummarizer, TraceSummarizerMap, TraceSummaryContext, TraceSummaryValue, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/observability/summaries/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/observability/summaries/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,YAAY,CAAC"}

package/dist/src/core/observability/summaries/index.js

@@ -0,0 +1,3 @@
+export { DEFAULT_TRACE_SUMMARIZERS } from './default-trace-summarizers.js';
+export { TraceSummaryService } from './trace-summary-service.js';
+//# sourceMappingURL=index.js.map

package/dist/src/core/observability/summaries/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/observability/summaries/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/src/core/observability/summaries/trace-summary-service.d.ts

@@ -0,0 +1,17 @@
+import type { TraceEvent } from '../../../core/types.js';
+import type { TraceSummarizerMap, TraceSummaryContext } from './types.js';
+/**
+ * Summarizes trace events into durable evidence strings for turn/session
+ * records. It owns event summarization policy, not live host status rendering.
+ */
+export declare class TraceSummaryService {
+    private static readonly defaultService;
+    private readonly summarizers;
+    constructor(summarizers?: TraceSummarizerMap);
+    static default(): TraceSummaryService;
+    summarizeEvent(event: TraceEvent, context: TraceSummaryContext): string[];
+    summarizeTrace(trace: TraceEvent[]): string[];
+    countAssistantSteps(trace: TraceEvent[]): number;
+    private static normalizeSummary;
+}
+//# sourceMappingURL=trace-summary-service.d.ts.map

package/dist/src/core/observability/summaries/trace-summary-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-summary-service.d.ts","sourceRoot":"","sources":["../../../../../src/core/observability/summaries/trace-summary-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAqB,MAAM,YAAY,CAAC;AAE7F;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAA6B;IAEnE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;gBAErC,WAAW,GAAE,kBAAuB;IAIhD,MAAM,CAAC,OAAO,IAAI,mBAAmB;IAIrC,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,mBAAmB,GAAG,MAAM,EAAE;IAKzE,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,EAAE;IAI7C,mBAAmB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM;IAIhD,OAAO,CAAC,MAAM,CAAC,gBAAgB;CAOhC"}

package/dist/src/core/observability/summaries/trace-summary-service.js

@@ -0,0 +1,32 @@
+import { DEFAULT_TRACE_SUMMARIZERS } from './default-trace-summarizers.js';
+/**
+ * Summarizes trace events into durable evidence strings for turn/session
+ * records. It owns event summarization policy, not live host status rendering.
+ */
+export class TraceSummaryService {
+    static defaultService = new TraceSummaryService();
+    summarizers;
+    constructor(summarizers = {}) {
+        this.summarizers = { ...DEFAULT_TRACE_SUMMARIZERS, ...summarizers };
+    }
+    static default() {
+        return TraceSummaryService.defaultService;
+    }
+    summarizeEvent(event, context) {
+        const handler = this.summarizers[event.type];
+        return TraceSummaryService.normalizeSummary(handler?.(event, context));
+    }
+    summarizeTrace(trace) {
+        return trace.flatMap((event, index) => this.summarizeEvent(event, { trace, index }));
+    }
+    countAssistantSteps(trace) {
+        return trace.filter((event) => event.type === 'assistant.turn').length;
+    }
+    static normalizeSummary(summary) {
+        if (Array.isArray(summary)) {
+            return summary;
+        }
+        return summary ? [summary] : [];
+    }
+}
+//# sourceMappingURL=trace-summary-service.js.map

package/dist/src/core/observability/summaries/trace-summary-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-summary-service.js","sourceRoot":"","sources":["../../../../../src/core/observability/summaries/trace-summary-service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAG3E;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IACtB,MAAM,CAAU,cAAc,GAAG,IAAI,mBAAmB,EAAE,CAAC;IAElD,WAAW,CAAqB;IAEjD,YAAY,cAAkC,EAAE;QAC9C,IAAI,CAAC,WAAW,GAAG,EAAE,GAAG,yBAAyB,EAAE,GAAG,WAAW,EAAE,CAAC;IACtE,CAAC;IAED,MAAM,CAAC,OAAO;QACZ,OAAO,mBAAmB,CAAC,cAAc,CAAC;IAC5C,CAAC;IAED,cAAc,CAAC,KAAiB,EAAE,OAA4B;QAC5D,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAyF,CAAC;QACrI,OAAO,mBAAmB,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IACzE,CAAC;IAED,cAAc,CAAC,KAAmB;QAChC,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACvF,CAAC;IAED,mBAAmB,CAAC,KAAmB;QACrC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,gBAAgB,CAAC,CAAC,MAAM,CAAC;IACzE,CAAC;IAEO,MAAM,CAAC,gBAAgB,CAAC,OAA0B;QACxD,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAClC,CAAC"}

package/dist/src/core/observability/summaries/types.d.ts

@@ -0,0 +1,15 @@
+import type { TraceEvent } from '../../../core/types.js';
+export type TraceEventType = TraceEvent['type'];
+export type TraceSummaryContext = {
+    trace: TraceEvent[];
+    index: number;
+};
+export type TraceEventOfType<Type extends TraceEventType> = Extract<TraceEvent, {
+    type: Type;
+}>;
+export type TraceSummaryValue = string | string[] | undefined;
+export type TraceSummarizer<Type extends TraceEventType = TraceEventType> = (event: TraceEventOfType<Type>, context: TraceSummaryContext) => TraceSummaryValue;
+export type TraceSummarizerMap = {
+    [Type in TraceEventType]?: TraceSummarizer<Type>;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/src/core/observability/summaries/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/core/observability/summaries/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;AAEhD,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,gBAAgB,CAAC,IAAI,SAAS,cAAc,IAAI,OAAO,CAAC,UAAU,EAAE;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,CAAC,CAAC;AAEhG,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;AAE9D,MAAM,MAAM,eAAe,CAAC,IAAI,SAAS,cAAc,GAAG,cAAc,IAAI,CAC1E,KAAK,EAAE,gBAAgB,CAAC,IAAI,CAAC,EAC7B,OAAO,EAAE,mBAAmB,KACzB,iBAAiB,CAAC;AAEvB,MAAM,MAAM,kBAAkB,GAAG;KAC9B,IAAI,IAAI,cAAc,CAAC,CAAC,EAAE,eAAe,CAAC,IAAI,CAAC;CACjD,CAAC"}

package/dist/src/core/observability/summaries/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map