@framers/agentos 0.1.49 → 0.1.51

package/dist/api/AgentOSOrchestrator.js

@@ -7,6 +7,12 @@
  * coordinating tool execution and result feedback.
  * @module backend/agentos/api/AgentOSOrchestrator
  */
+import { TaskOutcomeTelemetryManager, evaluateTaskOutcome, resolveTaskOutcomeTelemetryConfig, resolveAdaptiveExecutionConfig, } from './TaskOutcomeTelemetryManager.js';
+import { StreamChunkEmitter } from './StreamChunkEmitter.js';
+import { executeRollingSummaryPhase } from './turn-phases/rolling-summary.js';
+import { executePromptProfilePhase } from './turn-phases/prompt-profile.js';
+import { executeLongTermMemoryPhase } from './turn-phases/long-term-memory.js';
+import { assembleConversationHistory } from './turn-phases/conversation-history.js';
 import { AgentOSResponseChunkType, } from './types/AgentOSResponse.js';
 import { GMIInteractionType, // Added for GMITurnInput
 GMIOutputChunkType, // Added for comparisons
@@ -15,10 +21,13 @@ import { MessageRole } from '../core/conversation/ConversationMessage.js';
 import { uuidv4 } from '../utils/uuid.js';
 import { GMIError, GMIErrorCode } from '../utils/errors.js';
 import { normalizeUsage, snapshotPersonaDetails } from '../core/orchestration/helpers.js';
-import { DEFAULT_PROMPT_PROFILE_CONFIG, selectPromptProfile, } from '../core/prompting/PromptProfileRouter.js';
-import { DEFAULT_ROLLING_SUMMARY_COMPACTION_CONFIG, maybeCompactConversationMessages, } from '../core/conversation/RollingSummaryCompactor.js';
+import { DEFAULT_PROMPT_PROFILE_CONFIG, } from '../core/prompting/PromptProfileRouter.js';
+import { DEFAULT_ROLLING_SUMMARY_COMPACTION_CONFIG, } from '../core/conversation/RollingSummaryCompactor.js';
 import { DEFAULT_LONG_TERM_MEMORY_POLICY, hasAnyLongTermMemoryScope, LONG_TERM_MEMORY_POLICY_METADATA_KEY, resolveLongTermMemoryPolicy, } from '../core/conversation/LongTermMemoryPolicy.js';
-import { getActiveTraceMetadata, recordAgentOSToolResultMetrics, recordAgentOSTurnMetrics, recordExceptionOnActiveSpan, runWithSpanContext, shouldIncludeTraceInAgentOSResponses, startAgentOSSpan, withAgentOSSpan, } from '../core/observability/otel.js';
+import { recordAgentOSToolResultMetrics, recordAgentOSTurnMetrics, recordExceptionOnActiveSpan, runWithSpanContext, startAgentOSSpan, withAgentOSSpan, } from '../core/observability/otel.js';
+// TaskOutcomeKpiWindowEntry imported from types/OrchestratorConfig.ts
+// AdaptiveExecutionDecision imported from TaskOutcomeTelemetryManager
+// ITaskOutcomeTelemetryStore imported from types/OrchestratorConfig.ts
 const RECALL_PROFILE_DEFAULTS = {
     aggressive: {
         cadenceTurns: 2,
@@ -39,22 +48,6 @@ const RECALL_PROFILE_DEFAULTS = {
         topKByScope: { user: 4, persona: 4, organization: 4 },
     },
 };
-function normalizeMode(value) {
-    return (value || '').trim().toLowerCase();
-}
-function pickByMode(map, mode) {
-    if (!map || Object.keys(map).length === 0)
-        return null;
-    const modeNorm = normalizeMode(mode);
-    const exact = map[modeNorm];
-    if (exact)
-        return exact;
-    const patternMatch = Object.entries(map)
-        .map(([key, value]) => ({ key: normalizeMode(key), value }))
-        .filter(({ key }) => key && (modeNorm === key || modeNorm.startsWith(key) || modeNorm.includes(key)))
-        .sort((a, b) => b.key.length - a.key.length)[0];
-    return patternMatch?.value ?? null;
-}
 function renderPlainText(markdown) {
     let text = String(markdown ?? '');
     if (!text.trim())
@@ -82,92 +75,8 @@ function renderPlainText(markdown) {
     text = text.replace(/\n{3,}/g, '\n\n');
     return text.trim();
 }
-function normalizeTaskOutcomeOverride(customFlags) {
-    if (!customFlags)
-        return null;
-    const read = (keys) => {
-        for (const key of keys) {
-            if (Object.prototype.hasOwnProperty.call(customFlags, key))
-                return customFlags[key];
-        }
-        return undefined;
-    };
-    const raw = read(['taskOutcome', 'task_outcome', 'taskSuccess', 'task_success']);
-    if (typeof raw === 'boolean') {
-        return {
-            status: raw ? 'success' : 'failed',
-            score: raw ? 1 : 0,
-            reason: raw ? 'Caller marked task successful.' : 'Caller marked task failed.',
-            source: 'request_override',
-        };
-    }
-    if (typeof raw === 'number' && Number.isFinite(raw)) {
-        const score = Math.max(0, Math.min(1, raw));
-        return {
-            status: score >= 0.8 ? 'success' : score >= 0.4 ? 'partial' : 'failed',
-            score,
-            reason: 'Caller supplied numeric task outcome score.',
-            source: 'request_override',
-        };
-    }
-    if (typeof raw !== 'string' || !raw.trim())
-        return null;
-    const normalized = raw.trim().toLowerCase().replace(/\s+/g, '_').replace(/-/g, '_');
-    if (normalized === 'success' ||
-        normalized === 'succeeded' ||
-        normalized === 'done' ||
-        normalized === 'completed' ||
-        normalized === 'true') {
-        return {
-            status: 'success',
-            score: 1,
-            reason: 'Caller marked task successful.',
-            source: 'request_override',
-        };
-    }
-    if (normalized === 'partial' ||
-        normalized === 'incomplete' ||
-        normalized === 'needs_followup') {
-        return {
-            status: 'partial',
-            score: 0.5,
-            reason: 'Caller marked task partially completed.',
-            source: 'request_override',
-        };
-    }
-    if (normalized === 'failed' ||
-        normalized === 'failure' ||
-        normalized === 'error' ||
-        normalized === 'false') {
-        return {
-            status: 'failed',
-            score: 0,
-            reason: 'Caller marked task failed.',
-            source: 'request_override',
-        };
-    }
-    return null;
-}
-function normalizeRequestedToolFailureMode(customFlags) {
-    if (!customFlags)
-        return null;
-    const read = (keys) => {
-        for (const key of keys) {
-            if (Object.prototype.hasOwnProperty.call(customFlags, key))
-                return customFlags[key];
-        }
-        return undefined;
-    };
-    const raw = read(['toolFailureMode', 'tool_failure_mode', 'failureMode', 'failMode']);
-    if (typeof raw !== 'string')
-        return null;
-    const normalized = raw.trim().toLowerCase().replace(/\s+/g, '_').replace(/-/g, '_');
-    if (normalized === 'fail_open' || normalized === 'open')
-        return 'fail_open';
-    if (normalized === 'fail_closed' || normalized === 'closed')
-        return 'fail_closed';
-    return null;
-}
+// normalizeTaskOutcomeOverride, normalizeRequestedToolFailureMode
+// moved to TaskOutcomeTelemetryManager
 function clampInteger(value, fallback, min, max) {
     const num = Number(value);
     if (!Number.isFinite(num))
@@ -206,84 +115,6 @@ function resolveTenantRoutingConfig(config) {
         strictOrganizationIsolation: Boolean(config?.strictOrganizationIsolation),
     };
 }
-function resolveTaskOutcomeTelemetryConfig(config) {
-    const scope = config?.scope === 'global' || config?.scope === 'organization'
-        ? config.scope
-        : 'organization_persona';
-    return {
-        enabled: config?.enabled !== false,
-        rollingWindowSize: clampInteger(config?.rollingWindowSize, 100, 5, 5000),
-        scope,
-        emitAlerts: config?.emitAlerts !== false,
-        alertBelowWeightedSuccessRate: Math.max(0, Math.min(1, Number(config?.alertBelowWeightedSuccessRate ?? 0.55))),
-        alertMinSamples: clampInteger(config?.alertMinSamples, 8, 1, 10000),
-        alertCooldownMs: clampInteger(config?.alertCooldownMs, 60000, 0, 86400000),
-    };
-}
-function resolveAdaptiveExecutionConfig(config) {
-    return {
-        enabled: config?.enabled !== false,
-        minSamples: clampInteger(config?.minSamples, 5, 1, 1000),
-        minWeightedSuccessRate: Math.max(0, Math.min(1, Number(config?.minWeightedSuccessRate ?? 0.7))),
-        forceAllToolsWhenDegraded: config?.forceAllToolsWhenDegraded !== false,
-        forceFailOpenWhenDegraded: config?.forceFailOpenWhenDegraded !== false,
-    };
-}
-function sanitizeKpiEntry(raw) {
-    const status = raw?.status;
-    const validStatus = status === 'success' || status === 'partial' || status === 'failed' ? status : null;
-    if (!validStatus)
-        return null;
-    const scoreNum = Number(raw?.score);
-    const timestampNum = Number(raw?.timestamp);
-    if (!Number.isFinite(scoreNum) || !Number.isFinite(timestampNum))
-        return null;
-    return {
-        status: validStatus,
-        score: Math.max(0, Math.min(1, scoreNum)),
-        timestamp: Math.max(0, Math.trunc(timestampNum)),
-    };
-}
-function evaluateTaskOutcome(args) {
-    const override = normalizeTaskOutcomeOverride(args.customFlags);
-    if (override)
-        return override;
-    if (args.didForceTerminate || args.finalOutput.error) {
-        return {
-            status: 'failed',
-            score: 0,
-            reason: args.didForceTerminate
-                ? 'Turn force-terminated due to iteration cap.'
-                : 'Final response contains an error payload.',
-            source: 'heuristic',
-        };
-    }
-    const text = typeof args.finalOutput.responseText === 'string'
-        ? args.finalOutput.responseText.trim()
-        : '';
-    if (text.length >= 48) {
-        return {
-            status: 'success',
-            score: args.degraded ? 0.85 : 0.95,
-            reason: 'Final response was produced without terminal errors.',
-            source: 'heuristic',
-        };
-    }
-    if (text.length > 0 || (args.finalOutput.toolCalls?.length ?? 0) > 0) {
-        return {
-            status: 'partial',
-            score: args.degraded ? 0.5 : 0.6,
-            reason: 'Turn completed but produced a limited final response.',
-            source: 'heuristic',
-        };
-    }
-    return {
-        status: 'failed',
-        score: 0.1,
-        reason: 'No usable final response was produced.',
-        source: 'heuristic',
-    };
-}
 /**
  * @class AgentOSOrchestrator
  * @description
@@ -296,8 +127,6 @@ function evaluateTaskOutcome(args) {
 export class AgentOSOrchestrator {
     constructor() {
         this.initialized = false;
-        this.taskOutcomeKpiWindows = new Map();
-        this.taskOutcomeAlertState = new Map();
         /**
          * A map to hold ongoing stream contexts.
          * Key: streamId (generated by orchestrator for this interaction flow).
@@ -343,30 +172,10 @@ export class AgentOSOrchestrator {
             taskOutcomeTelemetry: resolveTaskOutcomeTelemetryConfig(config.taskOutcomeTelemetry),
             adaptiveExecution: resolveAdaptiveExecutionConfig(config.adaptiveExecution),
         };
-        this.taskOutcomeKpiWindows.clear();
-        this.taskOutcomeAlertState.clear();
         this.dependencies = dependencies;
-        if (dependencies.taskOutcomeTelemetryStore && this.config.taskOutcomeTelemetry.enabled) {
-            try {
-                const persisted = await dependencies.taskOutcomeTelemetryStore.loadWindows();
-                const cap = this.config.taskOutcomeTelemetry.rollingWindowSize;
-                for (const [scopeKey, rawEntries] of Object.entries(persisted ?? {})) {
-                    if (!Array.isArray(rawEntries))
-                        continue;
-                    const normalized = rawEntries
-                        .map((entry) => sanitizeKpiEntry(entry))
-                        .filter((entry) => Boolean(entry))
-                        .sort((a, b) => a.timestamp - b.timestamp);
-                    if (normalized.length === 0)
-                        continue;
-                    const trimmed = normalized.slice(Math.max(0, normalized.length - cap));
-                    this.taskOutcomeKpiWindows.set(scopeKey, trimmed);
-                }
-            }
-            catch (error) {
-                console.warn('AgentOSOrchestrator: Failed to load persisted task outcome telemetry windows; continuing with empty windows.', error);
-            }
-        }
+        this.chunks = new StreamChunkEmitter(dependencies.streamingManager, this.activeStreamContexts);
+        this.telemetry = new TaskOutcomeTelemetryManager(this.config.taskOutcomeTelemetry, this.config.adaptiveExecution, dependencies.taskOutcomeTelemetryStore);
+        await this.telemetry.loadPersistedWindows();
         this.initialized = true;
         console.log('AgentOSOrchestrator initialized.');
     }
@@ -403,304 +212,9 @@ export class AgentOSOrchestrator {
         }
         return inbound;
     }
-    resolveTaskOutcomeScopeKey(args) {
-        const scope = this.config.taskOutcomeTelemetry.scope;
-        const org = normalizeOrganizationId(args.organizationId) ?? 'none';
-        const persona = normalizeOrganizationId(args.personaId) ?? 'unknown';
-        if (scope === 'global')
-            return 'global';
-        if (scope === 'organization')
-            return `org:${org}`;
-        return `org:${org}|persona:${persona}`;
-    }
-    updateTaskOutcomeKpi(args) {
-        const telemetry = this.config.taskOutcomeTelemetry;
-        if (!telemetry.enabled)
-            return null;
-        const scopeKey = this.resolveTaskOutcomeScopeKey({
-            organizationId: args.organizationId,
-            personaId: args.personaId,
-        });
-        const now = Date.now();
-        const window = this.taskOutcomeKpiWindows.get(scopeKey) ?? [];
-        window.push({
-            status: args.outcome.status,
-            score: Math.max(0, Math.min(1, Number(args.outcome.score) || 0)),
-            timestamp: now,
-        });
-        const cap = telemetry.rollingWindowSize;
-        if (window.length > cap) {
-            window.splice(0, window.length - cap);
-        }
-        this.taskOutcomeKpiWindows.set(scopeKey, window);
-        if (this.dependencies.taskOutcomeTelemetryStore) {
-            const snapshot = window.map((entry) => ({ ...entry }));
-            void this.dependencies.taskOutcomeTelemetryStore
-                .saveWindow(scopeKey, snapshot)
-                .catch((error) => {
-                console.warn(`AgentOSOrchestrator: Failed to persist task outcome telemetry window for scope '${scopeKey}'.`, error);
-            });
-        }
-        return this.summarizeTaskOutcomeWindow(scopeKey);
-    }
-    getCurrentTaskOutcomeKpi(args) {
-        if (!this.config.taskOutcomeTelemetry.enabled)
-            return null;
-        const scopeKey = this.resolveTaskOutcomeScopeKey({
-            organizationId: args.organizationId,
-            personaId: args.personaId,
-        });
-        return this.summarizeTaskOutcomeWindow(scopeKey);
-    }
-    summarizeTaskOutcomeWindow(scopeKey) {
-        const telemetry = this.config.taskOutcomeTelemetry;
-        const window = this.taskOutcomeKpiWindows.get(scopeKey) ?? [];
-        if (window.length === 0)
-            return null;
-        const now = Date.now();
-        let successCount = 0;
-        let partialCount = 0;
-        let failedCount = 0;
-        let scoreSum = 0;
-        for (const entry of window) {
-            if (entry.status === 'success')
-                successCount += 1;
-            else if (entry.status === 'partial')
-                partialCount += 1;
-            else
-                failedCount += 1;
-            scoreSum += entry.score;
-        }
-        const sampleCount = window.length;
-        const successRate = sampleCount > 0 ? successCount / sampleCount : 0;
-        const averageScore = sampleCount > 0 ? scoreSum / sampleCount : 0;
-        return {
-            scopeKey,
-            scopeMode: telemetry.scope,
-            windowSize: telemetry.rollingWindowSize,
-            sampleCount,
-            successCount,
-            partialCount,
-            failedCount,
-            successRate,
-            averageScore,
-            weightedSuccessRate: averageScore,
-            timestamp: new Date(now).toISOString(),
-        };
-    }
-    maybeApplyAdaptiveExecutionPolicy(args) {
-        const adaptive = this.config.adaptiveExecution;
-        if (!adaptive.enabled || !args.turnPlan)
-            return { applied: false };
-        const kpi = this.getCurrentTaskOutcomeKpi({
-            organizationId: args.organizationId,
-            personaId: args.personaId,
-        });
-        if (!kpi)
-            return { applied: false, kpi };
-        if (kpi.sampleCount < adaptive.minSamples)
-            return { applied: false, kpi };
-        if (kpi.weightedSuccessRate >= adaptive.minWeightedSuccessRate)
-            return { applied: false, kpi };
-        const reasons = [
-            `weightedSuccessRate=${kpi.weightedSuccessRate.toFixed(3)} below threshold=${adaptive.minWeightedSuccessRate.toFixed(3)}`,
-        ];
-        let forcedToolSelectionMode = false;
-        let forcedToolFailureMode = false;
-        let preservedRequestedFailClosed = false;
-        if (adaptive.forceAllToolsWhenDegraded &&
-            args.turnPlan.policy.toolSelectionMode === 'discovered') {
-            args.turnPlan.policy.toolSelectionMode = 'all';
-            forcedToolSelectionMode = true;
-            reasons.push('toolSelectionMode switched discovered -> all');
-        }
-        if (adaptive.forceFailOpenWhenDegraded && args.turnPlan.policy.toolFailureMode !== 'fail_open') {
-            const requestedFailureMode = normalizeRequestedToolFailureMode(args.requestCustomFlags);
-            if (requestedFailureMode === 'fail_closed') {
-                preservedRequestedFailClosed = true;
-                reasons.push('preserved explicit request override toolFailureMode=fail_closed');
-            }
-            else {
-                const before = args.turnPlan.policy.toolFailureMode;
-                args.turnPlan.policy.toolFailureMode = 'fail_open';
-                forcedToolFailureMode = true;
-                reasons.push(`toolFailureMode switched ${before} -> fail_open`);
-            }
-        }
-        if (!forcedToolSelectionMode && !forcedToolFailureMode) {
-            return {
-                applied: false,
-                reason: preservedRequestedFailClosed
-                    ? 'Adaptive execution detected degraded KPI but preserved explicit fail-closed request override.'
-                    : undefined,
-                kpi,
-                actions: preservedRequestedFailClosed
-                    ? {
-                        preservedRequestedFailClosed: true,
-                    }
-                    : undefined,
-            };
-        }
-        args.turnPlan.capability.fallbackApplied = true;
-        args.turnPlan.capability.fallbackReason = `Adaptive fallback applied: ${reasons.join('; ')}.`;
-        args.turnPlan.diagnostics.usedFallback = true;
-        return {
-            applied: true,
-            reason: args.turnPlan.capability.fallbackReason,
-            kpi,
-            actions: {
-                forcedToolSelectionMode,
-                forcedToolFailureMode,
-                preservedRequestedFailClosed: preservedRequestedFailClosed || undefined,
-            },
-        };
-    }
-    maybeBuildTaskOutcomeAlert(kpi) {
-        const telemetry = this.config.taskOutcomeTelemetry;
-        if (!telemetry.enabled || !telemetry.emitAlerts || !kpi)
-            return null;
-        if (kpi.sampleCount < telemetry.alertMinSamples)
-            return null;
-        if (kpi.weightedSuccessRate >= telemetry.alertBelowWeightedSuccessRate)
-            return null;
-        const now = Date.now();
-        const lastAlertAt = this.taskOutcomeAlertState.get(kpi.scopeKey) ?? 0;
-        if (telemetry.alertCooldownMs > 0 && now - lastAlertAt < telemetry.alertCooldownMs) {
-            return null;
-        }
-        this.taskOutcomeAlertState.set(kpi.scopeKey, now);
-        const severity = kpi.weightedSuccessRate < telemetry.alertBelowWeightedSuccessRate * 0.6
-            ? 'critical'
-            : 'warning';
-        return {
-            scopeKey: kpi.scopeKey,
-            severity,
-            reason: `Weighted success rate ${kpi.weightedSuccessRate.toFixed(3)} below alert threshold ` +
-                `${telemetry.alertBelowWeightedSuccessRate.toFixed(3)}.`,
-            threshold: telemetry.alertBelowWeightedSuccessRate,
-            value: kpi.weightedSuccessRate,
-            sampleCount: kpi.sampleCount,
-            timestamp: new Date(now).toISOString(),
-        };
-    }
-    /**
-     * Helper method to create and push response chunks via StreamingManager.
-     * @private
-     */
-    async pushChunkToStream(streamId, type, gmiInstanceId, personaId, isFinal, data) {
-        const baseChunk = {
-            type,
-            streamId,
-            gmiInstanceId,
-            personaId,
-            isFinal,
-            timestamp: new Date().toISOString(),
-        };
-        if (data && typeof data === 'object' && 'metadata' in data && data.metadata) {
-            baseChunk.metadata = data.metadata;
-        }
-        const ctx = this.activeStreamContexts.get(streamId);
-        if (ctx?.languageNegotiation) {
-            baseChunk.metadata = baseChunk.metadata || {};
-            if (!baseChunk.metadata.language)
-                baseChunk.metadata.language = ctx.languageNegotiation;
-        }
-        if (shouldIncludeTraceInAgentOSResponses() &&
-            (type === AgentOSResponseChunkType.METADATA_UPDATE ||
-                type === AgentOSResponseChunkType.FINAL_RESPONSE ||
-                type === AgentOSResponseChunkType.ERROR)) {
-            const traceMeta = getActiveTraceMetadata();
-            if (traceMeta) {
-                baseChunk.metadata = baseChunk.metadata || {};
-                baseChunk.metadata.trace = traceMeta;
-            }
-        }
-        let chunk;
-        switch (type) {
-            case AgentOSResponseChunkType.TEXT_DELTA:
-                chunk = { ...baseChunk, textDelta: data.textDelta };
-                break;
-            case AgentOSResponseChunkType.SYSTEM_PROGRESS:
-                chunk = {
-                    ...baseChunk,
-                    message: data.message,
-                    progressPercentage: data.progressPercentage,
-                    statusCode: data.statusCode,
-                };
-                break;
-            case AgentOSResponseChunkType.TOOL_CALL_REQUEST:
-                chunk = {
-                    ...baseChunk,
-                    toolCalls: data.toolCalls,
-                    rationale: data.rationale,
-                };
-                break;
-            case AgentOSResponseChunkType.TOOL_RESULT_EMISSION:
-                chunk = {
-                    ...baseChunk,
-                    toolCallId: data.toolCallId,
-                    toolName: data.toolName,
-                    toolResult: data.toolResult,
-                    isSuccess: data.isSuccess,
-                    errorMessage: data.errorMessage,
-                };
-                break;
-            case AgentOSResponseChunkType.UI_COMMAND:
-                chunk = { ...baseChunk, uiCommands: data.uiCommands };
-                break;
-            case AgentOSResponseChunkType.ERROR:
-                chunk = {
-                    ...baseChunk,
-                    code: data.code,
-                    message: data.message,
-                    details: data.details,
-                };
-                break;
-            case AgentOSResponseChunkType.FINAL_RESPONSE:
-                chunk = {
-                    ...baseChunk,
-                    finalResponseText: data.finalResponseText,
-                    finalToolCalls: data.finalToolCalls,
-                    finalUiCommands: data.finalUiCommands,
-                    audioOutput: data.audioOutput,
-                    imageOutput: data.imageOutput,
-                    usage: normalizeUsage(data.usage),
-                    reasoningTrace: data.reasoningTrace,
-                    error: data.error,
-                    updatedConversationContext: data.updatedConversationContext,
-                    activePersonaDetails: data.activePersonaDetails,
-                };
-                break;
-            case AgentOSResponseChunkType.WORKFLOW_UPDATE:
-                chunk = {
-                    ...baseChunk,
-                    workflow: data.workflow,
-                };
-                break;
-            case AgentOSResponseChunkType.METADATA_UPDATE:
-                chunk = {
-                    ...baseChunk,
-                    updates: data.updates,
-                };
-                break;
-            default:
-                console.error(`AgentOSOrchestrator: Unknown chunk type encountered in pushChunkToStream: ${type}`);
-                chunk = {
-                    ...baseChunk,
-                    type: AgentOSResponseChunkType.ERROR,
-                    code: GMIErrorCode.INTERNAL_SERVER_ERROR,
-                    message: `Unknown chunk type: ${type}`,
-                    details: data,
-                };
-        }
-        try {
-            await this.dependencies.streamingManager.pushChunk(streamId, chunk);
-        }
-        catch (pushError) {
-            // Gracefully handle attempts to push after a stream is closed or missing
-            console.error(`AgentOSOrchestrator: Failed to push chunk to stream ${streamId}. Type: ${type}. Error: ${pushError?.message}`, pushError);
-        }
-    }
+    // Task outcome telemetry methods delegated to this.telemetry (TaskOutcomeTelemetryManager)
+    // pushChunkToStream, pushErrorChunk, emitExecutionLifecycleUpdate
+    // delegated to this.chunks (StreamChunkEmitter)
     async broadcastWorkflowUpdate(update) {
         this.ensureInitialized();
         const targets = [];
@@ -726,32 +240,12 @@ export class AgentOSOrchestrator {
                 conversationId: update.workflow.conversationId,
                 status: update.workflow.status,
             };
-            await this.pushChunkToStream(streamId, AgentOSResponseChunkType.WORKFLOW_UPDATE, gmiId, context.personaId, false, {
+            await this.chunks.pushChunk(streamId, AgentOSResponseChunkType.WORKFLOW_UPDATE, gmiId, context.personaId, false, {
                 workflow: update,
                 metadata,
             });
         }));
     }
-    /**
-     * Helper method to create and push error chunks.
-     * @private
-     */
-    async pushErrorChunk(streamId, personaId, gmiInstanceId = 'unknown_gmi_instance', code, message, details) {
-        await this.pushChunkToStream(streamId, AgentOSResponseChunkType.ERROR, gmiInstanceId, personaId, true, // Errors are usually final for the current operation
-        { code: code.toString(), message, details });
-    }
-    async emitExecutionLifecycleUpdate(args) {
-        await this.pushChunkToStream(args.streamId, AgentOSResponseChunkType.METADATA_UPDATE, args.gmiInstanceId, args.personaId, false, {
-            updates: {
-                executionLifecycle: {
-                    phase: args.phase,
-                    status: args.status,
-                    timestamp: new Date().toISOString(),
-                    ...(args.details ? { details: args.details } : null),
-                },
-            },
-        });
-    }
     /**
      * Orchestrates a full logical turn for a user request.
      * This involves managing GMI interaction, tool calls, and streaming responses.
@@ -792,7 +286,7 @@ export class AgentOSOrchestrator {
             }
             console.error(`AgentOSOrchestrator: Critical unhandled error in _processTurnInternal for stream ${agentOSStreamId}:`, criticalError);
             try {
-                await this.pushErrorChunk(agentOSStreamId, input.selectedPersonaId || 'unknown_persona', 'orchestrator_critical', GMIErrorCode.INTERNAL_SERVER_ERROR, `A critical orchestration error occurred: ${criticalError.message}`, { name: criticalError.name, stack: criticalError.stack });
+                await this.chunks.pushError(agentOSStreamId, input.selectedPersonaId || 'unknown_persona', 'orchestrator_critical', GMIErrorCode.INTERNAL_SERVER_ERROR, `A critical orchestration error occurred: ${criticalError.message}`, { name: criticalError.name, stack: criticalError.stack });
                 await this.dependencies.streamingManager.closeStream(agentOSStreamId, 'Critical orchestrator error');
             }
             catch (cleanupError) {
@@ -855,7 +349,7 @@ export class AgentOSOrchestrator {
                 conversationContext, userApiKeys: input.userApiKeys, processingOptions: input.options
             };
             this.activeStreamContexts.set(agentOSStreamId, streamContext);
-            await this.pushChunkToStream(agentOSStreamId, AgentOSResponseChunkType.SYSTEM_PROGRESS, gmiInstanceIdForChunks, currentPersonaId, false, { message: `Initializing persona ${currentPersonaId}... GMI: ${gmiInstanceIdForChunks}`, progressPercentage: 10 });
+            await this.chunks.pushChunk(agentOSStreamId, AgentOSResponseChunkType.SYSTEM_PROGRESS, gmiInstanceIdForChunks, currentPersonaId, false, { message: `Initializing persona ${currentPersonaId}... GMI: ${gmiInstanceIdForChunks}`, progressPercentage: 10 });
             const gmiInput = this.constructGMITurnInput(agentOSStreamId, input, streamContext);
             let turnPlan = null;
             const resolvedOrganizationId = this.resolveOrganizationContext(input.organizationId);
@@ -880,7 +374,7 @@ export class AgentOSOrchestrator {
                     throw new GMIError(`Turn planning failed before execution: ${planningError?.message || String(planningError)}`, GMIErrorCode.PROCESSING_ERROR, { streamId: agentOSStreamId, planningError });
                 }
             }
-            const adaptiveExecution = this.maybeApplyAdaptiveExecutionPolicy({
+            const adaptiveExecution = this.telemetry.maybeApplyAdaptivePolicy({
                 turnPlan,
                 organizationId: resolvedOrganizationId,
                 personaId: currentPersonaId,
@@ -894,7 +388,7 @@ export class AgentOSOrchestrator {
                     actions: adaptiveExecution.actions,
                 }
                 : undefined;
-            await this.emitExecutionLifecycleUpdate({
+            await this.chunks.emitLifecycleUpdate({
                 streamId: agentOSStreamId,
                 gmiInstanceId: gmiInstanceIdForChunks,
                 personaId: currentPersonaId,
@@ -911,7 +405,7 @@ export class AgentOSOrchestrator {
             });
             if (turnPlan?.capability.fallbackApplied || adaptiveExecution.applied) {
                 lifecycleDegraded = true;
-                await this.emitExecutionLifecycleUpdate({
+                await this.chunks.emitLifecycleUpdate({
                     streamId: agentOSStreamId,
                     gmiInstanceId: gmiInstanceIdForChunks,
                     personaId: currentPersonaId,
@@ -997,106 +491,35 @@ export class AgentOSOrchestrator {
             const modeForRouting = typeof input.options?.customFlags?.mode === 'string' && input.options.customFlags.mode.trim()
                 ? input.options.customFlags.mode.trim()
                 : currentPersonaId;
-            // --- Rolling summary compaction (text + JSON metadata) ---
-            let rollingSummaryResult = null;
-            let rollingSummaryProfileId = null;
-            let rollingSummaryConfigForTurn = this.config.rollingSummaryCompactionConfig;
-            let rollingSummarySystemPromptForTurn = this.config.rollingSummarySystemPrompt;
-            if (this.config.rollingSummaryCompactionProfilesConfig) {
-                const profilesConfig = this.config.rollingSummaryCompactionProfilesConfig;
-                const picked = pickByMode(profilesConfig.defaultProfileByMode, modeForRouting) ??
-                    profilesConfig.defaultProfileId;
-                rollingSummaryProfileId = picked;
-                const profile = profilesConfig.profiles?.[picked];
-                if (profile?.config) {
-                    rollingSummaryConfigForTurn = profile.config;
-                }
-                if (profile?.systemPrompt) {
-                    rollingSummarySystemPromptForTurn = profile.systemPrompt;
-                }
-            }
-            if (conversationContext && rollingSummaryConfigForTurn) {
-                try {
-                    const llmCaller = async (call) => {
-                        const providerIdResolved = call.providerId ||
-                            this.dependencies.modelProviderManager.getProviderForModel(call.modelId)?.providerId ||
-                            this.dependencies.modelProviderManager.getDefaultProvider()?.providerId;
-                        if (!providerIdResolved) {
-                            throw new Error(`No provider resolved for rolling-summary model '${call.modelId}'.`);
-                        }
-                        const provider = this.dependencies.modelProviderManager.getProvider(providerIdResolved);
-                        if (!provider) {
-                            throw new Error(`Provider '${providerIdResolved}' not found for rolling-summary compaction.`);
-                        }
-                        const response = await provider.generateCompletion(call.modelId, call.messages, call.options);
-                        const choice = response?.choices?.[0];
-                        const responseContent = choice?.message?.content ?? choice?.text ?? '';
-                        if (typeof responseContent === 'string')
-                            return responseContent.trim();
-                        if (Array.isArray(responseContent)) {
-                            return responseContent
-                                .map((part) => (typeof part?.text === 'string' ? part.text : ''))
-                                .filter(Boolean)
-                                .join('\n')
-                                .trim();
-                        }
-                        return String(responseContent ?? '').trim();
-                    };
-                    const stateKey = this.config.rollingSummaryStateKey;
-                    const compaction = await maybeCompactConversationMessages({
-                        messages: conversationContext.getAllMessages(),
-                        sessionMetadata: conversationContext.getAllMetadata(),
-                        config: rollingSummaryConfigForTurn,
-                        llmCaller: ({ providerId, modelId, messages, options }) => llmCaller({ providerId, modelId, messages, options }),
-                        systemPrompt: rollingSummarySystemPromptForTurn,
-                        stateKey,
-                    });
-                    rollingSummaryResult = compaction;
-                    if (compaction.updatedSessionMetadata && Object.prototype.hasOwnProperty.call(compaction.updatedSessionMetadata, stateKey)) {
-                        conversationContext.setMetadata(stateKey, compaction.updatedSessionMetadata[stateKey]);
-                    }
-                }
-                catch (compactionError) {
-                    console.warn(`AgentOSOrchestrator: Rolling summary compaction failed for stream ${agentOSStreamId} (continuing without it).`, compactionError);
-                }
-            }
+            // --- Rolling summary compaction (delegated to turn-phases/rolling-summary) ---
+            const rollingSummaryPhase = await executeRollingSummaryPhase({
+                conversationContext,
+                modeForRouting,
+                streamId: agentOSStreamId,
+                rollingSummaryCompactionConfig: this.config.rollingSummaryCompactionConfig,
+                rollingSummaryCompactionProfilesConfig: this.config.rollingSummaryCompactionProfilesConfig,
+                rollingSummarySystemPrompt: this.config.rollingSummarySystemPrompt,
+                rollingSummaryStateKey: this.config.rollingSummaryStateKey,
+                modelProviderManager: this.dependencies.modelProviderManager,
+            });
+            const { result: rollingSummaryResult, profileId: rollingSummaryProfileId, configForTurn: rollingSummaryConfigForTurn } = rollingSummaryPhase;
+            const rollingSummaryEnabled = rollingSummaryPhase.enabled;
+            const rollingSummaryText = rollingSummaryPhase.summaryText;
             if (!gmiInput.metadata) {
                 gmiInput.metadata = {};
             }
-            const rollingSummaryEnabled = Boolean(rollingSummaryConfigForTurn?.enabled);
-            const rollingSummaryText = rollingSummaryEnabled && typeof rollingSummaryResult?.summaryText === 'string'
-                ? rollingSummaryResult.summaryText.trim()
-                : '';
             gmiInput.metadata.rollingSummary =
                 rollingSummaryEnabled && rollingSummaryText
                     ? { text: rollingSummaryText, json: rollingSummaryResult?.summaryJson ?? undefined }
                     : null;
-            // --- Prompt-profile routing (concise/deep/planner/reviewer) ---
-            let promptProfileSelection = null;
-            if (conversationContext && this.config.promptProfileConfig) {
-                try {
-                    const rawPrev = conversationContext.getMetadata('promptProfileState');
-                    const previousState = rawPrev && typeof rawPrev === 'object' && typeof rawPrev.presetId === 'string'
-                        ? rawPrev
-                        : null;
-                    const userMessageForRouting = gmiInput.type === GMIInteractionType.TEXT && typeof gmiInput.content === 'string'
-                        ? gmiInput.content
-                        : gmiInput.type === GMIInteractionType.MULTIMODAL_CONTENT
-                            ? JSON.stringify(gmiInput.content)
-                            : '';
-                    const selection = selectPromptProfile(this.config.promptProfileConfig, {
-                        conversationId: conversationContext.sessionId,
-                        mode: modeForRouting,
-                        userMessage: userMessageForRouting,
-                        didCompact: Boolean(rollingSummaryResult?.didCompact),
-                    }, previousState);
-                    promptProfileSelection = selection.result;
-                    conversationContext.setMetadata('promptProfileState', selection.nextState);
-                }
-                catch (routerError) {
-                    console.warn(`AgentOSOrchestrator: Prompt-profile routing failed for stream ${agentOSStreamId} (continuing without it).`, routerError);
-                }
-            }
+            // --- Prompt-profile routing (delegated to turn-phases/prompt-profile) ---
+            const promptProfileSelection = executePromptProfilePhase({
+                conversationContext,
+                promptProfileConfig: this.config.promptProfileConfig,
+                modeForRouting,
+                gmiInput,
+                didCompact: Boolean(rollingSummaryResult?.didCompact),
+            });
             gmiInput.metadata.promptProfile = promptProfileSelection
                 ? {
                     id: promptProfileSelection.presetId,
@@ -1104,127 +527,39 @@ export class AgentOSOrchestrator {
                     reason: promptProfileSelection.reason,
                 }
                 : null;
-            // --- Long-term memory retrieval (user/persona/org) ---
-            let longTermMemoryContextText = null;
-            let longTermMemoryRetrievalDiagnostics;
-            let longTermMemoryShouldReview = false;
-            let longTermMemoryReviewReason = null;
-            if (conversationContext &&
-                this.dependencies.longTermMemoryRetriever &&
-                Boolean(longTermMemoryPolicy?.enabled) &&
-                (Boolean(longTermMemoryPolicy?.scopes?.user) ||
-                    Boolean(longTermMemoryPolicy?.scopes?.persona) ||
-                    Boolean(longTermMemoryPolicy?.scopes?.organization))) {
-                try {
-                    const queryText = gmiInput.type === GMIInteractionType.TEXT && typeof gmiInput.content === 'string'
-                        ? gmiInput.content.trim()
-                        : gmiInput.type === GMIInteractionType.MULTIMODAL_CONTENT
-                            ? JSON.stringify(gmiInput.content).trim()
-                            : '';
-                    const userTurnCount = conversationContext.getAllMessages().filter((m) => m?.role === MessageRole.USER).length;
-                    const recallConfig = this.config.longTermMemoryRecall;
-                    const cadenceTurns = recallConfig.cadenceTurns;
-                    const forceOnCompaction = recallConfig.forceOnCompaction;
-                    const rawState = conversationContext.getMetadata('longTermMemoryRetrievalState');
-                    const prevState = rawState &&
-                        typeof rawState === 'object' &&
-                        typeof rawState.lastReviewedUserTurn === 'number'
-                        ? rawState
-                        : null;
-                    const turnsSinceReview = prevState
-                        ? Math.max(0, userTurnCount - prevState.lastReviewedUserTurn)
-                        : Number.POSITIVE_INFINITY;
-                    const dueToCadence = !prevState || turnsSinceReview >= cadenceTurns;
-                    const dueToCompaction = forceOnCompaction && Boolean(rollingSummaryResult?.didCompact);
-                    const shouldReview = dueToCadence || dueToCompaction;
-                    longTermMemoryShouldReview = shouldReview;
-                    if (shouldReview) {
-                        longTermMemoryReviewReason = !prevState
-                            ? 'initial_review'
-                            : dueToCompaction
-                                ? 'forced_on_compaction'
-                                : 'cadence_due';
-                    }
-                    else {
-                        longTermMemoryReviewReason = 'cadence_not_due';
-                    }
-                    if (shouldReview && queryText.length > 0) {
-                        const retrievalResult = await this.dependencies.longTermMemoryRetriever.retrieveLongTermMemory({
-                            userId: streamContext.userId,
-                            organizationId: organizationIdForMemory,
-                            conversationId: streamContext.conversationId,
-                            personaId: currentPersonaId,
-                            mode: modeForRouting,
-                            queryText,
-                            memoryPolicy: longTermMemoryPolicy ?? DEFAULT_LONG_TERM_MEMORY_POLICY,
-                            maxContextChars: recallConfig.maxContextChars,
-                            topKByScope: recallConfig.topKByScope,
-                        });
-                        if (retrievalResult?.contextText && retrievalResult.contextText.trim()) {
-                            longTermMemoryContextText = retrievalResult.contextText.trim();
-                            longTermMemoryRetrievalDiagnostics = retrievalResult.diagnostics;
-                        }
-                        conversationContext.setMetadata('longTermMemoryRetrievalState', {
-                            lastReviewedUserTurn: userTurnCount,
-                            lastReviewedAt: Date.now(),
-                        });
-                    }
-                    else if (shouldReview && queryText.length === 0) {
-                        longTermMemoryReviewReason = 'empty_query';
-                    }
-                }
-                catch (retrievalError) {
-                    console.warn(`AgentOSOrchestrator: Long-term memory retrieval failed for stream ${agentOSStreamId} (continuing without it).`, retrievalError);
-                    longTermMemoryReviewReason = 'retrieval_error';
-                }
-            }
-            else {
-                longTermMemoryReviewReason = 'retriever_not_applicable';
-            }
+            // --- Long-term memory retrieval (delegated to turn-phases/long-term-memory) ---
+            const longTermMemoryPhase = await executeLongTermMemoryPhase({
+                conversationContext,
+                longTermMemoryRetriever: this.dependencies.longTermMemoryRetriever,
+                longTermMemoryPolicy,
+                gmiInput,
+                streamId: agentOSStreamId,
+                userId: streamContext.userId,
+                organizationId: organizationIdForMemory,
+                conversationId: streamContext.conversationId,
+                personaId: currentPersonaId,
+                modeForRouting,
+                recallConfig: this.config.longTermMemoryRecall,
+                didCompact: Boolean(rollingSummaryResult?.didCompact),
+            });
+            const longTermMemoryContextText = longTermMemoryPhase.contextText;
+            const longTermMemoryRetrievalDiagnostics = longTermMemoryPhase.diagnostics;
+            const longTermMemoryShouldReview = longTermMemoryPhase.shouldReview;
+            const longTermMemoryReviewReason = longTermMemoryPhase.reviewReason;
             gmiInput.metadata.longTermMemoryContext =
                 typeof longTermMemoryContextText === 'string' && longTermMemoryContextText.length > 0
                     ? longTermMemoryContextText
                     : null;
-            // Provide a durable history snapshot for prompt construction so persona switches share memory.
-            // When rolling-summary compaction is enabled and a summary exists, trim history to:
-            // - keep the configured head messages verbatim
-            // - keep only messages after `summaryUptoTimestamp` (unsummarized tail)
-            if (conversationContext) {
-                const excludeRoles = new Set([MessageRole.ERROR, MessageRole.THOUGHT]);
-                const useTrimmedHistory = rollingSummaryEnabled &&
-                    typeof rollingSummaryResult?.summaryUptoTimestamp === 'number' &&
-                    rollingSummaryText.length > 0;
-                const rawHistory = useTrimmedHistory
-                    ? conversationContext.getAllMessages()
-                    : conversationContext.getHistory(undefined, [MessageRole.ERROR, MessageRole.THOUGHT]);
-                let historyForPrompt = rawHistory.filter((m) => m && !excludeRoles.has(m.role));
-                const last = historyForPrompt[historyForPrompt.length - 1];
-                if (last?.role === MessageRole.USER) {
-                    const content = typeof last.content === 'string' ? last.content.trim() : '';
-                    const inbound = gmiInput.type === GMIInteractionType.TEXT && typeof gmiInput.content === 'string'
-                        ? gmiInput.content.trim()
-                        : gmiInput.type === GMIInteractionType.MULTIMODAL_CONTENT
-                            ? JSON.stringify(gmiInput.content).trim()
-                            : '';
-                    if (content && inbound && content === inbound) {
-                        historyForPrompt = historyForPrompt.slice(0, -1);
-                    }
-                }
-                if (useTrimmedHistory) {
-                    const headCount = Math.max(0, rollingSummaryConfigForTurn?.headMessagesToKeep ?? 0);
-                    const head = historyForPrompt.slice(0, Math.min(headCount, historyForPrompt.length));
-                    const afterSummary = historyForPrompt.filter((m) => m && m.timestamp > rollingSummaryResult.summaryUptoTimestamp);
-                    const merged = [];
-                    const seen = new Set();
-                    for (const msg of [...head, ...afterSummary]) {
-                        const id = typeof msg?.id === 'string' ? msg.id : '';
-                        if (!id || seen.has(id))
-                            continue;
-                        seen.add(id);
-                        merged.push(msg);
-                    }
-                    historyForPrompt = merged;
-                }
+            // --- Conversation history assembly (delegated to turn-phases/conversation-history) ---
+            const historyForPrompt = assembleConversationHistory({
+                conversationContext,
+                gmiInput,
+                rollingSummaryEnabled,
+                rollingSummaryResult,
+                rollingSummaryText,
+                rollingSummaryConfigForTurn,
+            });
+            if (historyForPrompt) {
                 gmiInput.metadata.conversationHistoryForPrompt = historyForPrompt;
             }
             // Persist any compaction/router metadata updates prior to the main LLM call.
@@ -1269,7 +604,7 @@ export class AgentOSOrchestrator {
                 });
             }
             // Emit routing + memory metadata as a first-class chunk for clients.
-            await this.pushChunkToStream(agentOSStreamId, AgentOSResponseChunkType.METADATA_UPDATE, gmiInstanceIdForChunks, currentPersonaId, false, {
+            await this.chunks.pushChunk(agentOSStreamId, AgentOSResponseChunkType.METADATA_UPDATE, gmiInstanceIdForChunks, currentPersonaId, false, {
                 updates: {
                     promptProfile: promptProfileSelection,
                     organizationId: organizationIdForMemory ?? null,
@@ -1328,7 +663,7 @@ export class AgentOSOrchestrator {
             let currentToolCallIteration = 0;
             let continueProcessing = true;
             let lastGMIOutput; // To store the result from handleToolResult or final processTurnStream result
-            await this.emitExecutionLifecycleUpdate({
+            await this.chunks.emitLifecycleUpdate({
                 streamId: agentOSStreamId,
                 gmiInstanceId: gmiInstanceIdForChunks,
                 personaId: currentPersonaId,
@@ -1401,7 +736,7 @@ export class AgentOSOrchestrator {
             if (currentToolCallIteration >= this.config.maxToolCallIterations && continueProcessing) {
                 console.warn(`AgentOSOrchestrator: Max tool call iterations reached for stream ${agentOSStreamId}. Forcing termination.`);
                 didForceTerminate = true;
-                await this.pushErrorChunk(agentOSStreamId, currentPersonaId, gmiInstanceIdForChunks, GMIErrorCode.RATE_LIMIT_EXCEEDED, // Or a more specific code
+                await this.chunks.pushError(agentOSStreamId, currentPersonaId, gmiInstanceIdForChunks, GMIErrorCode.RATE_LIMIT_EXCEEDED, // Or a more specific code
                 'Agent reached maximum tool call iterations.', { maxIterations: this.config.maxToolCallIterations });
             }
             // Final processing at the end of the turn or if no more continuation.
@@ -1435,13 +770,13 @@ export class AgentOSOrchestrator {
                 customFlags: input.options?.customFlags,
             });
             turnMetricsTaskOutcome = taskOutcome;
-            const taskOutcomeKpi = this.updateTaskOutcomeKpi({
+            const taskOutcomeKpi = this.telemetry.updateKpi({
                 outcome: taskOutcome,
                 organizationId: organizationIdForMemory,
                 personaId: currentPersonaId,
             });
-            const taskOutcomeAlert = this.maybeBuildTaskOutcomeAlert(taskOutcomeKpi);
-            await this.pushChunkToStream(agentOSStreamId, AgentOSResponseChunkType.METADATA_UPDATE, gmiInstanceIdForChunks, currentPersonaId, false, {
+            const taskOutcomeAlert = this.telemetry.maybeBuildAlert(taskOutcomeKpi);
+            await this.chunks.pushChunk(agentOSStreamId, AgentOSResponseChunkType.METADATA_UPDATE, gmiInstanceIdForChunks, currentPersonaId, false, {
                 updates: {
                     taskOutcome,
                     taskOutcomeKpi,
@@ -1449,7 +784,7 @@ export class AgentOSOrchestrator {
                 },
             });
             if (turnMetricsStatus === 'error') {
-                await this.emitExecutionLifecycleUpdate({
+                await this.chunks.emitLifecycleUpdate({
                     streamId: agentOSStreamId,
                     gmiInstanceId: gmiInstanceIdForChunks,
                     personaId: currentPersonaId,
@@ -1465,7 +800,7 @@ export class AgentOSOrchestrator {
             }
             else {
                 if (lifecycleDegraded) {
-                    await this.emitExecutionLifecycleUpdate({
+                    await this.chunks.emitLifecycleUpdate({
                         streamId: agentOSStreamId,
                         gmiInstanceId: gmiInstanceIdForChunks,
                         personaId: currentPersonaId,
@@ -1476,7 +811,7 @@ export class AgentOSOrchestrator {
                         },
                     });
                 }
-                await this.emitExecutionLifecycleUpdate({
+                await this.chunks.emitLifecycleUpdate({
                     streamId: agentOSStreamId,
                     gmiInstanceId: gmiInstanceIdForChunks,
                     personaId: currentPersonaId,
@@ -1518,7 +853,7 @@ export class AgentOSOrchestrator {
                     console.warn(`AgentOSOrchestrator: Failed to persist assistant output to ConversationContext for stream ${agentOSStreamId}.`, persistError);
                 }
             }
-            await this.pushChunkToStream(agentOSStreamId, AgentOSResponseChunkType.FINAL_RESPONSE, gmiInstanceIdForChunks, currentPersonaId, true, {
+            await this.chunks.pushChunk(agentOSStreamId, AgentOSResponseChunkType.FINAL_RESPONSE, gmiInstanceIdForChunks, currentPersonaId, true, {
                 finalResponseText: finalGMIStateForResponse.responseText ?? null,
                 finalResponseTextPlain: typeof finalGMIStateForResponse.responseText === 'string'
                     ? renderPlainText(finalGMIStateForResponse.responseText)
@@ -1546,21 +881,21 @@ export class AgentOSOrchestrator {
                 reason: `Exception before completion: ${gmiErr.code}`,
                 source: 'heuristic',
             };
-            const taskOutcomeKpi = this.updateTaskOutcomeKpi({
+            const taskOutcomeKpi = this.telemetry.updateKpi({
                 outcome: turnMetricsTaskOutcome,
                 organizationId: organizationIdForMemory,
                 personaId: currentPersonaId,
             });
-            const taskOutcomeAlert = this.maybeBuildTaskOutcomeAlert(taskOutcomeKpi);
+            const taskOutcomeAlert = this.telemetry.maybeBuildAlert(taskOutcomeKpi);
             console.error(`AgentOSOrchestrator: Error during _processTurnInternal for stream ${agentOSStreamId}:`, gmiErr);
-            await this.pushChunkToStream(agentOSStreamId, AgentOSResponseChunkType.METADATA_UPDATE, gmiInstanceIdForChunks, currentPersonaId ?? 'unknown_persona', false, {
+            await this.chunks.pushChunk(agentOSStreamId, AgentOSResponseChunkType.METADATA_UPDATE, gmiInstanceIdForChunks, currentPersonaId ?? 'unknown_persona', false, {
                 updates: {
                     taskOutcome: turnMetricsTaskOutcome,
                     taskOutcomeKpi,
                     taskOutcomeAlert,
                 },
             });
-            await this.emitExecutionLifecycleUpdate({
+            await this.chunks.emitLifecycleUpdate({
                 streamId: agentOSStreamId,
                 gmiInstanceId: gmiInstanceIdForChunks,
                 personaId: currentPersonaId ?? 'unknown_persona',
@@ -1573,7 +908,7 @@ export class AgentOSOrchestrator {
                     taskOutcomeScore: turnMetricsTaskOutcome.score,
                 },
             });
-            await this.pushErrorChunk(agentOSStreamId, currentPersonaId ?? 'unknown_persona', gmiInstanceIdForChunks, gmiErr.code, gmiErr.message, gmiErr.details);
+            await this.chunks.pushError(agentOSStreamId, currentPersonaId ?? 'unknown_persona', gmiInstanceIdForChunks, gmiErr.code, gmiErr.message, gmiErr.details);
             await this.dependencies.streamingManager.closeStream(agentOSStreamId, "Error during turn processing.");
         }
         finally {
@@ -1632,7 +967,7 @@ export class AgentOSOrchestrator {
                 span?.setAttribute('agentos.tool_success', isSuccess);
                 try {
                     // Emit the tool result itself as a chunk
-                    await this.pushChunkToStream(agentOSStreamId, AgentOSResponseChunkType.TOOL_RESULT_EMISSION, gmiInstanceIdForChunks, personaId, false, { toolCallId, toolName, toolResult: toolOutput, isSuccess, errorMessage });
+                    await this.chunks.pushChunk(agentOSStreamId, AgentOSResponseChunkType.TOOL_RESULT_EMISSION, gmiInstanceIdForChunks, personaId, false, { toolCallId, toolName, toolResult: toolOutput, isSuccess, errorMessage });
                     // Persist tool result into ConversationContext for durable memory / prompt reconstruction.
                     if (this.config.enableConversationalPersistence && conversationContext) {
                         try {
@@ -1665,7 +1000,7 @@ export class AgentOSOrchestrator {
                     await this.processGMIOutput(agentOSStreamId, streamContext, gmiOutputAfterTool, false);
                     // If GMIOutput indicates further tool calls are needed by the GMI
                     if (gmiOutputAfterTool.toolCalls && gmiOutputAfterTool.toolCalls.length > 0) {
-                        await this.pushChunkToStream(agentOSStreamId, AgentOSResponseChunkType.TOOL_CALL_REQUEST, gmiInstanceIdForChunks, personaId, false, // Not final, more interaction expected
+                        await this.chunks.pushChunk(agentOSStreamId, AgentOSResponseChunkType.TOOL_CALL_REQUEST, gmiInstanceIdForChunks, personaId, false, // Not final, more interaction expected
                         {
                             toolCalls: gmiOutputAfterTool.toolCalls,
                             rationale: gmiOutputAfterTool.responseText || 'Agent requires further tool execution.',
@@ -1703,7 +1038,7 @@ export class AgentOSOrchestrator {
                         }
                         // If it's final and no more tool calls, the interaction for this GMI processing cycle might be done.
                         // Push a final response marker or the already pushed final data from processGMIOutput takes precedence.
-                        await this.pushChunkToStream(agentOSStreamId, AgentOSResponseChunkType.FINAL_RESPONSE, gmiInstanceIdForChunks, personaId, true, {
+                        await this.chunks.pushChunk(agentOSStreamId, AgentOSResponseChunkType.FINAL_RESPONSE, gmiInstanceIdForChunks, personaId, true, {
                             finalResponseText: gmiOutputAfterTool.responseText,
                             finalToolCalls: gmiOutputAfterTool.toolCalls,
                             finalUiCommands: gmiOutputAfterTool.uiCommands,
@@ -1725,7 +1060,7 @@ export class AgentOSOrchestrator {
                     const gmiErr = GMIError.wrap?.(error, GMIErrorCode.TOOL_ERROR, `Error in orchestrateToolResult for stream ${agentOSStreamId}`) ||
                         new GMIError(`Error in orchestrateToolResult for stream ${agentOSStreamId}: ${error.message}`, GMIErrorCode.TOOL_ERROR, error);
                     console.error(`AgentOSOrchestrator: Critical error processing tool result for stream ${agentOSStreamId}:`, gmiErr);
-                    await this.pushErrorChunk(agentOSStreamId, personaId, gmiInstanceIdForChunks, gmiErr.code, gmiErr.message, gmiErr.details);
+                    await this.chunks.pushError(agentOSStreamId, personaId, gmiInstanceIdForChunks, gmiErr.code, gmiErr.message, gmiErr.details);
                     this.activeStreamContexts.delete(agentOSStreamId);
                     await this.dependencies.streamingManager.closeStream(agentOSStreamId, 'Critical error during tool result processing.');
                     throw gmiErr; // Re-throw to signal failure to caller if necessary
@@ -1758,14 +1093,14 @@ export class AgentOSOrchestrator {
         const { gmi, personaId, conversationContext } = streamContext;
         const gmiInstanceIdForChunks = gmi.getGMIId();
         if (gmiOutput.responseText) {
-            await this.pushChunkToStream(agentOSStreamId, AgentOSResponseChunkType.TEXT_DELTA, gmiInstanceIdForChunks, personaId, false, // text delta is not final by itself
+            await this.chunks.pushChunk(agentOSStreamId, AgentOSResponseChunkType.TEXT_DELTA, gmiInstanceIdForChunks, personaId, false, // text delta is not final by itself
             { textDelta: gmiOutput.responseText });
         }
         if (gmiOutput.uiCommands && gmiOutput.uiCommands.length > 0) {
-            await this.pushChunkToStream(agentOSStreamId, AgentOSResponseChunkType.UI_COMMAND, gmiInstanceIdForChunks, personaId, false, { uiCommands: gmiOutput.uiCommands });
+            await this.chunks.pushChunk(agentOSStreamId, AgentOSResponseChunkType.UI_COMMAND, gmiInstanceIdForChunks, personaId, false, { uiCommands: gmiOutput.uiCommands });
         }
         if (gmiOutput.error) {
-            await this.pushErrorChunk(agentOSStreamId, personaId, gmiInstanceIdForChunks, gmiOutput.error.code, gmiOutput.error.message, gmiOutput.error.details);
+            await this.chunks.pushError(agentOSStreamId, personaId, gmiInstanceIdForChunks, gmiOutput.error.code, gmiOutput.error.message, gmiOutput.error.details);
             // If an error occurs in GMIOutput, it's usually final for this interaction path
             if (gmiOutput.isFinal) {
                 this.activeStreamContexts.delete(agentOSStreamId);
@@ -1784,7 +1119,7 @@ export class AgentOSOrchestrator {
                 });
             }
             // This is a final response without further tool calls
-            await this.pushChunkToStream(agentOSStreamId, AgentOSResponseChunkType.FINAL_RESPONSE, gmiInstanceIdForChunks, personaId, true, {
+            await this.chunks.pushChunk(agentOSStreamId, AgentOSResponseChunkType.FINAL_RESPONSE, gmiInstanceIdForChunks, personaId, true, {
                 finalResponseText: gmiOutput.responseText,
                 finalToolCalls: gmiOutput.toolCalls, // Should be empty or undefined here
                 finalUiCommands: gmiOutput.uiCommands,
@@ -1810,30 +1145,30 @@ export class AgentOSOrchestrator {
         switch (gmiChunk.type) {
             case GMIOutputChunkType.TEXT_DELTA:
                 if (gmiChunk.content && typeof gmiChunk.content === 'string') {
-                    await this.pushChunkToStream(agentOSStreamId, AgentOSResponseChunkType.TEXT_DELTA, gmiInstanceIdForChunks, personaId, gmiChunk.isFinal ?? false, { textDelta: gmiChunk.content });
+                    await this.chunks.pushChunk(agentOSStreamId, AgentOSResponseChunkType.TEXT_DELTA, gmiInstanceIdForChunks, personaId, gmiChunk.isFinal ?? false, { textDelta: gmiChunk.content });
                 }
                 break;
             case GMIOutputChunkType.SYSTEM_MESSAGE: // Was SystemProgress
                 if (gmiChunk.content && typeof gmiChunk.content === 'object') {
                     const progressContent = gmiChunk.content;
-                    await this.pushChunkToStream(agentOSStreamId, AgentOSResponseChunkType.SYSTEM_PROGRESS, gmiInstanceIdForChunks, personaId, gmiChunk.isFinal ?? false, progressContent);
+                    await this.chunks.pushChunk(agentOSStreamId, AgentOSResponseChunkType.SYSTEM_PROGRESS, gmiInstanceIdForChunks, personaId, gmiChunk.isFinal ?? false, progressContent);
                 }
                 break;
             case GMIOutputChunkType.TOOL_CALL_REQUEST:
                 if (gmiChunk.content && Array.isArray(gmiChunk.content)) {
                     const toolCalls = gmiChunk.content;
-                    await this.pushChunkToStream(agentOSStreamId, AgentOSResponseChunkType.TOOL_CALL_REQUEST, gmiInstanceIdForChunks, personaId, false, // Tool call request is not final for the AgentOS turn
+                    await this.chunks.pushChunk(agentOSStreamId, AgentOSResponseChunkType.TOOL_CALL_REQUEST, gmiInstanceIdForChunks, personaId, false, // Tool call request is not final for the AgentOS turn
                     { toolCalls, rationale: gmiChunk.metadata?.rationale || "Agent requires tool execution." });
                 }
                 break;
             case GMIOutputChunkType.UI_COMMAND:
                 if (gmiChunk.content && Array.isArray(gmiChunk.content)) {
-                    await this.pushChunkToStream(agentOSStreamId, AgentOSResponseChunkType.UI_COMMAND, gmiInstanceIdForChunks, personaId, gmiChunk.isFinal ?? false, { uiCommands: gmiChunk.content });
+                    await this.chunks.pushChunk(agentOSStreamId, AgentOSResponseChunkType.UI_COMMAND, gmiInstanceIdForChunks, personaId, gmiChunk.isFinal ?? false, { uiCommands: gmiChunk.content });
                 }
                 break;
             case GMIOutputChunkType.ERROR: {
                 const errDetails = gmiChunk.errorDetails || { message: gmiChunk.content };
-                await this.pushErrorChunk(agentOSStreamId, personaId, gmiInstanceIdForChunks, errDetails.code || GMIErrorCode.GMI_PROCESSING_ERROR, errDetails.message || String(gmiChunk.content) || 'Unknown GMI processing error.', errDetails.details || errDetails);
+                await this.chunks.pushError(agentOSStreamId, personaId, gmiInstanceIdForChunks, errDetails.code || GMIErrorCode.GMI_PROCESSING_ERROR, errDetails.message || String(gmiChunk.content) || 'Unknown GMI processing error.', errDetails.details || errDetails);
                 // If GMI sends an error chunk that it considers final for its operation
                 if (gmiChunk.isFinal) {
                     this.activeStreamContexts.delete(agentOSStreamId);
@@ -1935,8 +1270,8 @@ export class AgentOSOrchestrator {
             }
         }
         this.activeStreamContexts.clear();
-        this.taskOutcomeKpiWindows.clear();
-        this.taskOutcomeAlertState.clear();
+        this.telemetry?.kpiWindows.clear();
+        this.telemetry?.alertState.clear();
         this.initialized = false;
         console.log('AgentOSOrchestrator: Shutdown complete.');
     }