takt 0.43.0 → 0.45.0

package/dist/core/logging/phaseUsageEvent.js

@@ -0,0 +1,195 @@
+import { USAGE_MISSING_REASONS, } from './contracts.js';
+import { buildUsageEventPayload } from './providerEvent.js';
+import { isProviderType } from '../../shared/types/provider.js';
+export function mapSpanEndToPhaseUsageEvent(span, context) {
+    if (span.name.startsWith('phase.')) {
+        return mapPhaseSpan(span, context);
+    }
+    if (span.name.startsWith('judge_stage.')) {
+        return mapJudgeStageSpan(span, context);
+    }
+    return undefined;
+}
+function mapPhaseSpan(span, context) {
+    const phaseNumber = getNumber(span.attributes, 'takt.phase.number');
+    const phaseName = getPhaseName(span.attributes, 'takt.phase.name');
+    const phase = phaseLabelForPhaseSpan(phaseNumber, phaseName);
+    if (!phase || !phaseName) {
+        return undefined;
+    }
+    const common = buildCommonMeta(span);
+    if (!common) {
+        return undefined;
+    }
+    return buildRecord(span, context, {
+        ...common,
+        phase,
+        phaseName,
+        phaseExecutionId: getString(span.attributes, 'takt.phase.execution_id'),
+        success: getString(span.attributes, 'takt.phase.status') === 'done',
+    });
+}
+function mapJudgeStageSpan(span, context) {
+    const judgeStage = getJudgeStage(span.attributes, 'takt.judge.stage');
+    const judgeMethod = getJudgeMethod(span.attributes, 'takt.judge.method');
+    const phase = phaseLabelForJudgeStage(judgeStage);
+    if (!phase || !judgeStage || !judgeMethod) {
+        return undefined;
+    }
+    const common = buildCommonMeta(span);
+    if (!common) {
+        return undefined;
+    }
+    return buildRecord(span, context, {
+        ...common,
+        phase,
+        phaseName: 'judge',
+        phaseExecutionId: getString(span.attributes, 'takt.phase.execution_id'),
+        judgeStage,
+        judgeMethod,
+        success: getString(span.attributes, 'takt.judge.status') === 'done',
+    });
+}
+function buildCommonMeta(span) {
+    const provider = getProvider(span.attributes, 'takt.provider.name');
+    const step = getString(span.attributes, 'takt.step.name');
+    const stepType = getStepType(span.attributes, 'takt.step.type');
+    if (!provider || !step || !stepType) {
+        return undefined;
+    }
+    return {
+        provider,
+        providerModel: getString(span.attributes, 'takt.model.name') ?? '(default)',
+        step,
+        stepType,
+    };
+}
+function buildRecord(span, context, meta) {
+    const usage = extractUsage(span.attributes);
+    return {
+        run_id: context.runId,
+        session_id: context.sessionId,
+        provider: meta.provider,
+        provider_model: meta.providerModel,
+        step: meta.step,
+        step_type: meta.stepType,
+        phase: meta.phase,
+        phase_name: meta.phaseName,
+        ...(meta.phaseExecutionId ? { phase_execution_id: meta.phaseExecutionId } : {}),
+        ...(meta.judgeStage ? { judge_stage: meta.judgeStage } : {}),
+        ...(meta.judgeMethod ? { judge_method: meta.judgeMethod } : {}),
+        timestamp: hrTimeToIso(span.endTime),
+        success: meta.success,
+        usage_missing: usage.missing,
+        ...(usage.reason ? { reason: usage.reason } : {}),
+        usage: usage.usage,
+    };
+}
+function extractUsage(attributes) {
+    const snapshot = usageSnapshotFromAttributes(attributes);
+    const payload = buildUsageEventPayload(snapshot);
+    return {
+        missing: payload.usage_missing,
+        ...payload,
+    };
+}
+function usageSnapshotFromAttributes(attributes) {
+    if (attributes['takt.usage.missing'] === true) {
+        return {
+            usageMissing: true,
+            reason: getUsageMissingReason(attributes['takt.usage.missing_reason']),
+        };
+    }
+    const inputTokens = getNumber(attributes, 'gen_ai.usage.input_tokens');
+    const outputTokens = getNumber(attributes, 'gen_ai.usage.output_tokens');
+    const totalTokens = getNumber(attributes, 'gen_ai.usage.total_tokens')
+        ?? (inputTokens !== undefined && outputTokens !== undefined ? inputTokens + outputTokens : undefined);
+    if (inputTokens === undefined || outputTokens === undefined || totalTokens === undefined) {
+        return {
+            usageMissing: true,
+            reason: hasAnyUsageAttribute(attributes)
+                ? USAGE_MISSING_REASONS.TOKENS_MISSING
+                : USAGE_MISSING_REASONS.NOT_AVAILABLE,
+        };
+    }
+    return {
+        usageMissing: false,
+        inputTokens,
+        outputTokens,
+        totalTokens,
+        cachedInputTokens: getNumber(attributes, 'gen_ai.usage.cached_input_tokens'),
+        cacheCreationInputTokens: getNumber(attributes, 'gen_ai.usage.cache_creation_input_tokens'),
+        cacheReadInputTokens: getNumber(attributes, 'gen_ai.usage.cache_read_input_tokens'),
+    };
+}
+function hasAnyUsageAttribute(attributes) {
+    return Object.keys(attributes).some((key) => key.startsWith('gen_ai.usage.'));
+}
+function phaseLabelForPhaseSpan(phaseNumber, phaseName) {
+    if (phaseNumber === 1 && phaseName === 'execute') {
+        return 'phase1_execute';
+    }
+    if (phaseNumber === 2 && phaseName === 'report') {
+        return 'phase2_report';
+    }
+    return undefined;
+}
+function phaseLabelForJudgeStage(stage) {
+    switch (stage) {
+        case 1:
+            return 'phase3_structured';
+        case 2:
+            return 'phase3_tag';
+        case 3:
+            return 'phase3_fallback';
+        default:
+            return undefined;
+    }
+}
+function getString(attributes, key) {
+    const value = attributes[key];
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+function getNumber(attributes, key) {
+    const value = attributes[key];
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+function getProvider(attributes, key) {
+    const value = getString(attributes, key);
+    return isProviderType(value) ? value : undefined;
+}
+function getStepType(attributes, key) {
+    const value = getString(attributes, key);
+    return value === 'agent'
+        || value === 'system'
+        || value === 'workflow_call'
+        ? value
+        : undefined;
+}
+function getPhaseName(attributes, key) {
+    const value = getString(attributes, key);
+    return value === 'execute' || value === 'report' || value === 'judge' ? value : undefined;
+}
+function getJudgeStage(attributes, key) {
+    const value = getNumber(attributes, key);
+    return value === 1 || value === 2 || value === 3 ? value : undefined;
+}
+function getJudgeMethod(attributes, key) {
+    const value = getString(attributes, key);
+    return value === 'structured_output' || value === 'phase3_tag' || value === 'ai_judge' ? value : undefined;
+}
+function getUsageMissingReason(value) {
+    return value === USAGE_MISSING_REASONS.NOT_AVAILABLE
+        || value === USAGE_MISSING_REASONS.TOKENS_MISSING
+        || value === USAGE_MISSING_REASONS.NOT_SUPPORTED_BY_PROVIDER
+        ? value
+        : USAGE_MISSING_REASONS.NOT_AVAILABLE;
+}
+function hrTimeToIso(time) {
+    if (!time) {
+        return new Date().toISOString();
+    }
+    const [seconds, nanoseconds] = time;
+    return new Date((seconds * 1000) + Math.floor(nanoseconds / 1_000_000)).toISOString();
+}
+//# sourceMappingURL=phaseUsageEvent.js.map

package/dist/core/logging/phaseUsageEvent.js.map

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

package/dist/core/logging/providerEvent.d.ts

@@ -30,8 +30,11 @@ export interface UsageEventLogRecord {
         output_tokens?: number;
         total_tokens?: number;
         cached_input_tokens?: number;
+        cache_creation_input_tokens?: number;
+        cache_read_input_tokens?: number;
     };
 }
+export type UsageEventPayload = Pick<UsageEventLogRecord, 'usage_missing' | 'reason' | 'usage'>;
 interface UsageEventMeta {
     runId: string;
     sessionId: string;
@@ -47,5 +50,6 @@ interface BuildUsageRecordParams {
 }
 export declare function normalizeProviderEvent(event: StreamEvent, provider: ProviderType, step: string, runId: string): ProviderEventLogRecord;
 export declare function buildUsageEventRecord(meta: UsageEventMeta, params: BuildUsageRecordParams): UsageEventLogRecord;
+export declare function buildUsageEventPayload(usageSnapshot: ProviderUsageSnapshot): UsageEventPayload;
 export {};
 //# sourceMappingURL=providerEvent.d.ts.map

package/dist/core/logging/providerEvent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"providerEvent.d.ts","sourceRoot":"","sources":["../../../src/core/logging/providerEvent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAyB,KAAK,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEhF,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,aAAa,GAAG,eAAe,CAAC;AAE5F,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,YAAY,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,YAAY,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,QAAQ,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,KAAK,EAAE;QACL,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;KAC9B,CAAC;CACH;AAED,UAAU,cAAc;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,YAAY,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,UAAU,sBAAsB;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,qBAAqB,CAAC;IAC7B,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAkDD,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,sBAAsB,CAmBxB;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,sBAAsB,GAC7B,mBAAmB,CA6CrB"}
+{"version":3,"file":"providerEvent.d.ts","sourceRoot":"","sources":["../../../src/core/logging/providerEvent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAyB,KAAK,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEhF,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,aAAa,GAAG,eAAe,CAAC;AAE5F,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,YAAY,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,YAAY,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,QAAQ,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,KAAK,EAAE;QACL,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,2BAA2B,CAAC,EAAE,MAAM,CAAC;QACrC,uBAAuB,CAAC,EAAE,MAAM,CAAC;KAClC,CAAC;CACH;AAED,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,mBAAmB,EAAE,eAAe,GAAG,QAAQ,GAAG,OAAO,CAAC,CAAC;AAEhG,UAAU,cAAc;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,YAAY,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,UAAU,sBAAsB;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,qBAAqB,CAAC;IAC7B,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAkDD,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,sBAAsB,CAmBxB;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,sBAAsB,GAC7B,mBAAmB,CAarB;AAED,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,qBAAqB,GAAG,iBAAiB,CAmC9F"}

package/dist/core/logging/providerEvent.js

@@ -59,44 +59,48 @@ export function normalizeProviderEvent(event, provider, step, runId) {
     };
 }
 export function buildUsageEventRecord(meta, params) {
-    if (params.usage.usageMissing) {
-        if (typeof params.usage.reason !== 'string' || params.usage.reason.length === 0) {
+    const payload = buildUsageEventPayload(params.usage);
+    return {
+        run_id: meta.runId,
+        session_id: meta.sessionId,
+        provider: meta.provider,
+        provider_model: meta.providerModel,
+        step: meta.step,
+        step_type: meta.stepType,
+        timestamp: (params.timestamp ?? new Date()).toISOString(),
+        success: params.success,
+        ...payload,
+    };
+}
+export function buildUsageEventPayload(usageSnapshot) {
+    if (usageSnapshot.usageMissing) {
+        if (typeof usageSnapshot.reason !== 'string' || usageSnapshot.reason.length === 0) {
             throw new Error('[usage-events] reason is required when usageMissing=true');
         }
         return {
-            run_id: meta.runId,
-            session_id: meta.sessionId,
-            provider: meta.provider,
-            provider_model: meta.providerModel,
-            step: meta.step,
-            step_type: meta.stepType,
-            timestamp: (params.timestamp ?? new Date()).toISOString(),
-            success: params.success,
             usage_missing: true,
-            reason: assertUsageMissingReason(params.usage.reason),
+            reason: assertUsageMissingReason(usageSnapshot.reason),
             usage: {},
         };
     }
-    assertFiniteNumber(params.usage.inputTokens, 'usage.inputTokens');
-    assertFiniteNumber(params.usage.outputTokens, 'usage.outputTokens');
-    assertFiniteNumber(params.usage.totalTokens, 'usage.totalTokens');
+    assertFiniteNumber(usageSnapshot.inputTokens, 'usage.inputTokens');
+    assertFiniteNumber(usageSnapshot.outputTokens, 'usage.outputTokens');
+    assertFiniteNumber(usageSnapshot.totalTokens, 'usage.totalTokens');
     const usage = {
-        input_tokens: params.usage.inputTokens,
-        output_tokens: params.usage.outputTokens,
-        total_tokens: params.usage.totalTokens,
-        ...(Number.isFinite(params.usage.cachedInputTokens)
-            ? { cached_input_tokens: params.usage.cachedInputTokens }
+        input_tokens: usageSnapshot.inputTokens,
+        output_tokens: usageSnapshot.outputTokens,
+        total_tokens: usageSnapshot.totalTokens,
+        ...(Number.isFinite(usageSnapshot.cachedInputTokens)
+            ? { cached_input_tokens: usageSnapshot.cachedInputTokens }
+            : {}),
+        ...(Number.isFinite(usageSnapshot.cacheCreationInputTokens)
+            ? { cache_creation_input_tokens: usageSnapshot.cacheCreationInputTokens }
+            : {}),
+        ...(Number.isFinite(usageSnapshot.cacheReadInputTokens)
+            ? { cache_read_input_tokens: usageSnapshot.cacheReadInputTokens }
             : {}),
     };
     return {
-        run_id: meta.runId,
-        session_id: meta.sessionId,
-        provider: meta.provider,
-        provider_model: meta.providerModel,
-        step: meta.step,
-        step_type: meta.stepType,
-        timestamp: (params.timestamp ?? new Date()).toISOString(),
-        success: params.success,
         usage_missing: false,
         usage,
     };

package/dist/core/logging/providerEvent.js.map

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

package/dist/core/logging/span-to-ndjson-mapper.d.ts

@@ -0,0 +1,10 @@
+import type { NdjsonRecord } from '../../shared/utils/index.js';
+export interface SpanSnapshot {
+    name: string;
+    attributes: Record<string, unknown>;
+    startTime?: readonly [number, number];
+    endTime?: readonly [number, number];
+}
+export declare function mapSpanStartToNdjson(span: SpanSnapshot): NdjsonRecord | undefined;
+export declare function mapSpanEndToNdjson(span: SpanSnapshot): NdjsonRecord | undefined;
+//# sourceMappingURL=span-to-ndjson-mapper.d.ts.map

package/dist/core/logging/span-to-ndjson-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"span-to-ndjson-mapper.d.ts","sourceRoot":"","sources":["../../../src/core/logging/span-to-ndjson-mapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EASb,MAAM,6BAA6B,CAAC;AAGrC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,SAAS,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,OAAO,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAQD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY,GAAG,SAAS,CAQjF;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY,GAAG,SAAS,CAc/E"}

package/dist/core/logging/span-to-ndjson-mapper.js

@@ -0,0 +1,311 @@
+import { AGENT_FAILURE_CATEGORIES } from '../../shared/types/agent-failure.js';
+export function mapSpanStartToNdjson(span) {
+    if (span.name.startsWith('phase.')) {
+        return mapPhaseStart(span);
+    }
+    if (!span.name.startsWith('step.')) {
+        return undefined;
+    }
+    return mapStepStart(span);
+}
+export function mapSpanEndToNdjson(span) {
+    if (span.name.startsWith('workflow.')) {
+        return mapWorkflowEnd(span);
+    }
+    if (span.name.startsWith('step.')) {
+        return mapStepComplete(span);
+    }
+    if (span.name.startsWith('phase.')) {
+        return mapPhaseComplete(span);
+    }
+    if (span.name.startsWith('judge_stage.')) {
+        return mapJudgeStage(span);
+    }
+    return undefined;
+}
+function mapWorkflowEnd(span) {
+    const resumeDepth = getNumber(span.attributes, 'takt.workflow.resume_depth') ?? 0;
+    if (resumeDepth > 0) {
+        return undefined;
+    }
+    const status = getString(span.attributes, 'takt.workflow.status');
+    if (status === undefined || status === 'running') {
+        return undefined;
+    }
+    const iterations = getNumber(span.attributes, 'takt.workflow.iterations') ?? 0;
+    const endTime = getTimestamp(span.endTime);
+    if (status === 'aborted') {
+        return {
+            type: 'workflow_abort',
+            iterations,
+            reason: getString(span.attributes, 'takt.workflow.abort.reason') ?? getString(span.attributes, 'takt.workflow.abort.kind') ?? 'Workflow aborted',
+            endTime,
+        };
+    }
+    return {
+        type: 'workflow_complete',
+        iterations,
+        endTime,
+    };
+}
+function mapStepStart(span) {
+    const step = getString(span.attributes, 'takt.step.name');
+    const persona = getString(span.attributes, 'takt.step.persona');
+    const iteration = getNumber(span.attributes, 'takt.step.iteration');
+    if (!step || !persona || iteration == null) {
+        return undefined;
+    }
+    const providerOptions = parseJsonValue(getString(span.attributes, 'takt.provider.options'));
+    const providerOptionsSources = parseJsonRecord(getString(span.attributes, 'takt.provider.options_sources'));
+    return {
+        type: 'step_start',
+        step,
+        persona,
+        iteration,
+        timestamp: getTimestamp(span.startTime),
+        ...getWorkflowStack(span.attributes),
+        ...optionalString('instruction', getString(span.attributes, 'takt.step.instruction')),
+        ...optionalString('provider', getString(span.attributes, 'takt.provider.name')),
+        ...optionalString('providerSource', getString(span.attributes, 'takt.provider.source')),
+        ...optionalString('model', getString(span.attributes, 'takt.model.name')),
+        ...optionalString('modelSource', getString(span.attributes, 'takt.model.source')),
+        ...(providerOptions !== undefined ? { providerOptions } : {}),
+        ...(providerOptionsSources !== undefined ? { providerOptionsSources } : {}),
+    };
+}
+function mapStepComplete(span) {
+    const step = getString(span.attributes, 'takt.step.name');
+    const persona = getString(span.attributes, 'takt.step.result.persona') ?? getString(span.attributes, 'takt.step.persona');
+    const iteration = getNumber(span.attributes, 'takt.step.iteration');
+    const status = getString(span.attributes, 'takt.step.status');
+    if (!step || !persona || iteration == null || !status) {
+        return undefined;
+    }
+    const matchedRuleIndex = getNumber(span.attributes, 'takt.step.result.matched_rule_index');
+    const failureCategory = getString(span.attributes, 'takt.step.result.failure_category');
+    return {
+        type: 'step_complete',
+        step,
+        persona,
+        iteration,
+        status,
+        content: getString(span.attributes, 'takt.step.result.content') ?? '',
+        instruction: getString(span.attributes, 'takt.step.instruction') ?? '',
+        ...getWorkflowStack(span.attributes),
+        ...(matchedRuleIndex != null ? { matchedRuleIndex } : {}),
+        ...optionalString('matchedRuleMethod', getString(span.attributes, 'takt.step.result.matched_rule_method')),
+        ...optionalString('matchMethod', getString(span.attributes, 'takt.step.result.match_method')),
+        ...optionalString('error', getString(span.attributes, 'takt.step.result.error')),
+        ...(isAgentFailureCategory(failureCategory) ? { failureCategory } : {}),
+        timestamp: getString(span.attributes, 'takt.step.result.timestamp') ?? getTimestamp(span.endTime),
+    };
+}
+function mapPhaseStart(span) {
+    const step = getString(span.attributes, 'takt.step.name');
+    const phase = getPhaseNumber(span.attributes, 'takt.phase.number');
+    const phaseName = getPhaseName(span.attributes, 'takt.phase.name');
+    const phaseExecutionId = getString(span.attributes, 'takt.phase.execution_id');
+    const systemPrompt = getString(span.attributes, 'takt.phase.system_prompt');
+    const userInstruction = getString(span.attributes, 'takt.phase.user_instruction');
+    if (!step
+        || phase === undefined
+        || phaseName === undefined
+        || !phaseExecutionId
+        || systemPrompt === undefined
+        || userInstruction === undefined) {
+        return undefined;
+    }
+    return {
+        type: 'phase_start',
+        step,
+        ...optionalNumber('iteration', getNumber(span.attributes, 'takt.step.iteration')),
+        ...getWorkflowStack(span.attributes),
+        phase,
+        phaseName,
+        phaseExecutionId,
+        timestamp: getTimestamp(span.startTime),
+        ...optionalString('instruction', getString(span.attributes, 'takt.phase.instruction')),
+        systemPrompt,
+        userInstruction,
+    };
+}
+function mapPhaseComplete(span) {
+    const step = getString(span.attributes, 'takt.step.name');
+    const phase = getPhaseNumber(span.attributes, 'takt.phase.number');
+    const phaseName = getPhaseName(span.attributes, 'takt.phase.name');
+    const phaseExecutionId = getString(span.attributes, 'takt.phase.execution_id');
+    const status = getString(span.attributes, 'takt.phase.status');
+    if (!step
+        || phase === undefined
+        || phaseName === undefined
+        || !phaseExecutionId
+        || !status) {
+        return undefined;
+    }
+    // Parity gate, scoped by phase: the canonical log emits phase_complete
+    // unconditionally ONLY for the judge phase (its catch fires onPhaseComplete
+    // even when prompts never resolved). For execute/report the canonical
+    // onPhaseComplete is reached only after prompt parts resolved, so requiring
+    // them here avoids emitting an orphaned phase_complete (no preceding
+    // phase_start) when the agent throws early. system_prompt/user_instruction
+    // are not part of NdjsonPhaseComplete — they are used only as the gate.
+    if (phaseName !== 'judge') {
+        const systemPrompt = getString(span.attributes, 'takt.phase.system_prompt');
+        const userInstruction = getString(span.attributes, 'takt.phase.user_instruction');
+        if (systemPrompt === undefined || userInstruction === undefined) {
+            return undefined;
+        }
+    }
+    return {
+        type: 'phase_complete',
+        step,
+        ...optionalNumber('iteration', getNumber(span.attributes, 'takt.step.iteration')),
+        ...getWorkflowStack(span.attributes),
+        phase,
+        phaseName,
+        phaseExecutionId,
+        status,
+        ...optionalString('content', getString(span.attributes, 'takt.phase.result.content')),
+        timestamp: getTimestamp(span.endTime),
+        ...optionalString('error', getString(span.attributes, 'takt.phase.result.error')),
+    };
+}
+function mapJudgeStage(span) {
+    const step = getString(span.attributes, 'takt.step.name');
+    const stage = getJudgeStage(span.attributes, 'takt.judge.stage');
+    const method = getJudgeMethod(span.attributes, 'takt.judge.method');
+    const status = getJudgeStatus(span.attributes, 'takt.judge.status');
+    const instruction = getString(span.attributes, 'takt.judge.instruction');
+    const response = getString(span.attributes, 'takt.judge.response');
+    if (!step || stage === undefined || method === undefined || status === undefined || instruction === undefined || response === undefined) {
+        return undefined;
+    }
+    return {
+        type: 'phase_judge_stage',
+        step,
+        ...optionalNumber('iteration', getNumber(span.attributes, 'takt.step.iteration')),
+        ...getWorkflowStack(span.attributes),
+        phase: 3,
+        phaseName: 'judge',
+        ...optionalString('phaseExecutionId', getString(span.attributes, 'takt.phase.execution_id')),
+        stage,
+        method,
+        status,
+        instruction,
+        response,
+        timestamp: getTimestamp(span.endTime),
+    };
+}
+function getWorkflowStack(attributes) {
+    const workflow = getString(attributes, 'takt.workflow.current_name');
+    const stackJson = getString(attributes, 'takt.workflow.stack');
+    const stack = parseWorkflowStack(stackJson);
+    return {
+        ...(workflow ? { workflow } : {}),
+        ...(stack ? { stack } : {}),
+    };
+}
+function parseWorkflowStack(value) {
+    if (!value) {
+        return undefined;
+    }
+    try {
+        const parsed = JSON.parse(value);
+        if (!Array.isArray(parsed)) {
+            return undefined;
+        }
+        const stack = [];
+        for (const entry of parsed) {
+            if (!isWorkflowStackEntry(entry)) {
+                return undefined;
+            }
+            stack.push(entry);
+        }
+        return stack;
+    }
+    catch {
+        return undefined;
+    }
+}
+function parseJsonValue(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return undefined;
+    }
+}
+function parseJsonRecord(value) {
+    const parsed = parseJsonValue(value);
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        return undefined;
+    }
+    const result = {};
+    for (const [key, item] of Object.entries(parsed)) {
+        if (typeof item === 'string') {
+            result[key] = item;
+        }
+    }
+    return result;
+}
+function isWorkflowStackEntry(value) {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const entry = value;
+    return typeof entry.workflow === 'string'
+        && (entry.workflow_ref === undefined || typeof entry.workflow_ref === 'string')
+        && typeof entry.step === 'string'
+        && (entry.kind === 'agent' || entry.kind === 'system' || entry.kind === 'workflow_call');
+}
+function isAgentFailureCategory(value) {
+    return value === AGENT_FAILURE_CATEGORIES.EXTERNAL_ABORT
+        || value === AGENT_FAILURE_CATEGORIES.PART_TIMEOUT
+        || value === AGENT_FAILURE_CATEGORIES.PROVIDER_ERROR
+        || value === AGENT_FAILURE_CATEGORIES.STREAM_IDLE_TIMEOUT;
+}
+function getString(attributes, key) {
+    const value = attributes[key];
+    return typeof value === 'string' ? value : undefined;
+}
+function getNumber(attributes, key) {
+    const value = attributes[key];
+    return typeof value === 'number' ? value : undefined;
+}
+function getPhaseNumber(attributes, key) {
+    const value = getNumber(attributes, key);
+    return value === 1 || value === 2 || value === 3 ? value : undefined;
+}
+function getPhaseName(attributes, key) {
+    const value = getString(attributes, key);
+    return value === 'execute' || value === 'report' || value === 'judge' ? value : undefined;
+}
+function getJudgeStage(attributes, key) {
+    const value = getNumber(attributes, key);
+    return value === 1 || value === 2 || value === 3 ? value : undefined;
+}
+function getJudgeMethod(attributes, key) {
+    const value = getString(attributes, key);
+    return value === 'structured_output' || value === 'phase3_tag' || value === 'ai_judge' ? value : undefined;
+}
+function getJudgeStatus(attributes, key) {
+    const value = getString(attributes, key);
+    return value === 'done' || value === 'error' || value === 'skipped' ? value : undefined;
+}
+function optionalString(key, value) {
+    return value !== undefined ? { [key]: value } : {};
+}
+function optionalNumber(key, value) {
+    return value !== undefined ? { [key]: value } : {};
+}
+function getTimestamp(time) {
+    if (!time) {
+        return new Date().toISOString();
+    }
+    const [seconds, nanoseconds] = time;
+    return new Date((seconds * 1000) + Math.floor(nanoseconds / 1_000_000)).toISOString();
+}
+//# sourceMappingURL=span-to-ndjson-mapper.js.map