@framers/agentos 0.1.49 → 0.1.50

package/dist/api/TaskOutcomeTelemetryManager.js

@@ -0,0 +1,331 @@
+/**
+ * @fileoverview Task outcome telemetry — rolling KPI windows, adaptive execution,
+ * and alert generation. Extracted from AgentOSOrchestrator for readability.
+ */
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function clampInteger(value, fallback, min, max) {
+    const n = Number(value);
+    if (!Number.isFinite(n))
+        return fallback;
+    return Math.max(min, Math.min(max, Math.trunc(n)));
+}
+export 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),
+    };
+}
+export 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,
+    };
+}
+export 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 normalizeTaskOutcomeOverride(customFlags) {
+    if (!customFlags)
+        return null;
+    const raw = customFlags.taskOutcome ?? customFlags.task_outcome;
+    if (raw == null)
+        return null;
+    if (typeof raw === 'boolean') {
+        return {
+            status: raw ? 'success' : 'failed',
+            score: raw ? 1 : 0,
+            reason: 'Caller explicitly set task outcome boolean.',
+            source: 'request_override',
+        };
+    }
+    if (typeof raw === 'number') {
+        const clamped = Math.max(0, Math.min(1, raw));
+        return {
+            status: clamped >= 0.7 ? 'success' : clamped >= 0.3 ? 'partial' : 'failed',
+            score: clamped,
+            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 (['success', 'succeeded', 'done', 'completed', 'true'].includes(normalized)) {
+        return { status: 'success', score: 1, reason: 'Caller marked task successful.', source: 'request_override' };
+    }
+    if (['failed', 'failure', 'error', 'false'].includes(normalized)) {
+        return { status: 'failed', score: 0, reason: 'Caller marked task failed.', source: 'request_override' };
+    }
+    if (['partial', 'partially', 'mixed'].includes(normalized)) {
+        return { status: 'partial', score: 0.5, reason: 'Caller marked task as partial.', source: 'request_override' };
+    }
+    return null;
+}
+function normalizeRequestedToolFailureMode(customFlags) {
+    if (!customFlags)
+        return null;
+    const raw = customFlags.toolFailureMode ?? customFlags.tool_failure_mode;
+    if (typeof raw !== 'string')
+        return null;
+    const normalized = raw.trim().toLowerCase().replace(/\s+/g, '_').replace(/-/g, '_');
+    if (normalized === 'fail_open')
+        return 'fail_open';
+    if (normalized === 'fail_closed')
+        return 'fail_closed';
+    return null;
+}
+export 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',
+    };
+}
+// ---------------------------------------------------------------------------
+// Manager
+// ---------------------------------------------------------------------------
+function normalizeOrganizationId(value) {
+    if (typeof value !== 'string')
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+/**
+ * Manages rolling task outcome KPI windows, adaptive execution policies,
+ * and alert generation. Designed to be used as a delegate within AgentOSOrchestrator.
+ */
+export class TaskOutcomeTelemetryManager {
+    constructor(telemetryConfig, adaptiveConfig, store) {
+        this.telemetryConfig = telemetryConfig;
+        this.adaptiveConfig = adaptiveConfig;
+        this.store = store;
+        this.kpiWindows = new Map();
+        this.alertState = new Map();
+    }
+    async loadPersistedWindows() {
+        if (!this.store || !this.telemetryConfig.enabled)
+            return;
+        try {
+            const persisted = await this.store.loadWindows();
+            const cap = this.telemetryConfig.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;
+                this.kpiWindows.set(scopeKey, normalized.slice(Math.max(0, normalized.length - cap)));
+            }
+        }
+        catch (error) {
+            console.warn('TaskOutcomeTelemetryManager: Failed to load persisted windows.', error);
+        }
+    }
+    resolveScopeKey(args) {
+        const scope = this.telemetryConfig.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}`;
+    }
+    updateKpi(args) {
+        if (!this.telemetryConfig.enabled)
+            return null;
+        const scopeKey = this.resolveScopeKey(args);
+        const window = this.kpiWindows.get(scopeKey) ?? [];
+        window.push({
+            status: args.outcome.status,
+            score: Math.max(0, Math.min(1, Number(args.outcome.score) || 0)),
+            timestamp: Date.now(),
+        });
+        const cap = this.telemetryConfig.rollingWindowSize;
+        if (window.length > cap)
+            window.splice(0, window.length - cap);
+        this.kpiWindows.set(scopeKey, window);
+        if (this.store) {
+            void this.store
+                .saveWindow(scopeKey, window.map((e) => ({ ...e })))
+                .catch((err) => console.warn(`Failed to persist KPI window for '${scopeKey}'.`, err));
+        }
+        return this.summarizeWindow(scopeKey);
+    }
+    getCurrentKpi(args) {
+        if (!this.telemetryConfig.enabled)
+            return null;
+        return this.summarizeWindow(this.resolveScopeKey(args));
+    }
+    summarizeWindow(scopeKey) {
+        const window = this.kpiWindows.get(scopeKey) ?? [];
+        if (window.length === 0)
+            return null;
+        let successCount = 0, partialCount = 0, failedCount = 0, scoreSum = 0;
+        for (const entry of window) {
+            if (entry.status === 'success')
+                successCount++;
+            else if (entry.status === 'partial')
+                partialCount++;
+            else
+                failedCount++;
+            scoreSum += entry.score;
+        }
+        const sampleCount = window.length;
+        return {
+            scopeKey,
+            scopeMode: this.telemetryConfig.scope,
+            windowSize: this.telemetryConfig.rollingWindowSize,
+            sampleCount,
+            successCount,
+            partialCount,
+            failedCount,
+            successRate: sampleCount > 0 ? successCount / sampleCount : 0,
+            averageScore: sampleCount > 0 ? scoreSum / sampleCount : 0,
+            weightedSuccessRate: sampleCount > 0 ? scoreSum / sampleCount : 0,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    maybeApplyAdaptivePolicy(args) {
+        if (!this.adaptiveConfig.enabled || !args.turnPlan)
+            return { applied: false };
+        const kpi = this.getCurrentKpi({ organizationId: args.organizationId, personaId: args.personaId });
+        if (!kpi)
+            return { applied: false, kpi };
+        if (kpi.sampleCount < this.adaptiveConfig.minSamples)
+            return { applied: false, kpi };
+        if (kpi.weightedSuccessRate >= this.adaptiveConfig.minWeightedSuccessRate)
+            return { applied: false, kpi };
+        const reasons = [
+            `weightedSuccessRate=${kpi.weightedSuccessRate.toFixed(3)} below threshold=${this.adaptiveConfig.minWeightedSuccessRate.toFixed(3)}`,
+        ];
+        let forcedToolSelectionMode = false;
+        let forcedToolFailureMode = false;
+        let preservedRequestedFailClosed = false;
+        if (this.adaptiveConfig.forceAllToolsWhenDegraded && args.turnPlan.policy.toolSelectionMode === 'discovered') {
+            args.turnPlan.policy.toolSelectionMode = 'all';
+            forcedToolSelectionMode = true;
+            reasons.push('toolSelectionMode switched discovered -> all');
+        }
+        if (this.adaptiveConfig.forceFailOpenWhenDegraded && args.turnPlan.policy.toolFailureMode !== 'fail_open') {
+            const requested = normalizeRequestedToolFailureMode(args.requestCustomFlags);
+            if (requested === '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,
+            },
+        };
+    }
+    maybeBuildAlert(kpi) {
+        if (!this.telemetryConfig.enabled || !this.telemetryConfig.emitAlerts || !kpi)
+            return null;
+        if (kpi.sampleCount < this.telemetryConfig.alertMinSamples)
+            return null;
+        if (kpi.weightedSuccessRate >= this.telemetryConfig.alertBelowWeightedSuccessRate)
+            return null;
+        const now = Date.now();
+        const lastAlertAt = this.alertState.get(kpi.scopeKey) ?? 0;
+        if (this.telemetryConfig.alertCooldownMs > 0 && now - lastAlertAt < this.telemetryConfig.alertCooldownMs)
+            return null;
+        this.alertState.set(kpi.scopeKey, now);
+        return {
+            scopeKey: kpi.scopeKey,
+            severity: kpi.weightedSuccessRate < this.telemetryConfig.alertBelowWeightedSuccessRate * 0.6 ? 'critical' : 'warning',
+            reason: `Weighted success rate ${kpi.weightedSuccessRate.toFixed(3)} below alert threshold ${this.telemetryConfig.alertBelowWeightedSuccessRate.toFixed(3)}.`,
+            threshold: this.telemetryConfig.alertBelowWeightedSuccessRate,
+            value: kpi.weightedSuccessRate,
+            sampleCount: kpi.sampleCount,
+            timestamp: new Date(now).toISOString(),
+        };
+    }
+}
+//# sourceMappingURL=TaskOutcomeTelemetryManager.js.map

package/dist/api/TaskOutcomeTelemetryManager.js.map

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

package/dist/api/errors.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @fileoverview Custom error class for AgentOS service facade errors.
+ */
+import { GMIError, GMIErrorCode } from '../utils/errors';
+/**
+ * Custom error class for errors specifically originating from the AgentOS service facade.
+ * Provides a standardized way to represent errors encountered within the `AgentOS` class.
+ */
+export declare class AgentOSServiceError extends GMIError {
+    readonly name: string;
+    constructor(message: string, code: GMIErrorCode | string, details?: any, componentOrigin?: string);
+    /**
+     * Wraps an existing error within a new AgentOSServiceError instance.
+     */
+    static wrap(error: any, code: GMIErrorCode | string, message: string, componentOrigin?: string): AgentOSServiceError;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/api/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/api/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAEvE;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,QAAQ;IAC/C,SAAyB,IAAI,EAAE,MAAM,CAAyB;gBAElD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,eAAe,CAAC,EAAE,MAAM;IAKjG;;OAEG;WACoB,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,mBAAmB;CAYrI"}

package/dist/api/errors.js

@@ -0,0 +1,25 @@
+/**
+ * @fileoverview Custom error class for AgentOS service facade errors.
+ */
+import { GMIError } from '../utils/errors.js';
+/**
+ * Custom error class for errors specifically originating from the AgentOS service facade.
+ * Provides a standardized way to represent errors encountered within the `AgentOS` class.
+ */
+export class AgentOSServiceError extends GMIError {
+    constructor(message, code, details, componentOrigin) {
+        super(message, code, details, componentOrigin);
+        this.name = 'AgentOSServiceError';
+        Object.setPrototypeOf(this, AgentOSServiceError.prototype);
+    }
+    /**
+     * Wraps an existing error within a new AgentOSServiceError instance.
+     */
+    static wrap(error, code, message, componentOrigin) {
+        const baseMessage = error instanceof Error ? error.message : String(error);
+        const originalComponent = error instanceof GMIError ? error.component : undefined;
+        const originalDetails = error instanceof GMIError ? error.details : { underlyingError: error };
+        return new AgentOSServiceError(`${message}: ${baseMessage}`, code, originalDetails, componentOrigin || originalComponent);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/api/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/api/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAgB,MAAM,+BAA+B,CAAC;AAEvE;;;GAGG;AACH,MAAM,OAAO,mBAAoB,SAAQ,QAAQ;IAG/C,YAAY,OAAe,EAAE,IAA2B,EAAE,OAAa,EAAE,eAAwB;QAC/F,KAAK,CAAC,OAAO,EAAE,IAAoB,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC;QAHxC,SAAI,GAAW,qBAAqB,CAAC;QAI5D,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAC7D,CAAC;IAED;;OAEG;IACI,MAAM,CAAU,IAAI,CAAC,KAAU,EAAE,IAA2B,EAAE,OAAe,EAAE,eAAwB;QAC5G,MAAM,WAAW,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3E,MAAM,iBAAiB,GAAG,KAAK,YAAY,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;QAClF,MAAM,eAAe,GAAG,KAAK,YAAY,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC;QAE/F,OAAO,IAAI,mBAAmB,CAC5B,GAAG,OAAO,KAAK,WAAW,EAAE,EAC5B,IAAI,EACJ,eAAe,EACf,eAAe,IAAI,iBAAiB,CACrC,CAAC;IACJ,CAAC;CACF"}

package/dist/api/turn-phases/conversation-history.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @fileoverview Conversation history assembly phase.
+ * Builds a trimmed, deduplicated history snapshot for prompt construction.
+ */
+import type { ConversationContext } from '../../core/conversation/ConversationContext';
+import { type GMITurnInput } from '../../cognitive_substrate/IGMI';
+import type { RollingSummaryCompactionConfig, RollingSummaryCompactionResult } from '../../core/conversation/RollingSummaryCompactor';
+export interface ConversationHistoryPhaseInput {
+    conversationContext: ConversationContext | undefined;
+    gmiInput: GMITurnInput;
+    rollingSummaryEnabled: boolean;
+    rollingSummaryResult: RollingSummaryCompactionResult | null;
+    rollingSummaryText: string;
+    rollingSummaryConfigForTurn: RollingSummaryCompactionConfig | null;
+}
+/**
+ * Build a conversation history snapshot for prompt construction.
+ * When rolling summary is active, trims history to head messages + unsummarized tail.
+ * Deduplicates the current user message if already in history.
+ */
+export declare function assembleConversationHistory(input: ConversationHistoryPhaseInput): any[] | null;
+//# sourceMappingURL=conversation-history.d.ts.map

package/dist/api/turn-phases/conversation-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-history.d.ts","sourceRoot":"","sources":["../../../src/api/turn-phases/conversation-history.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6CAA6C,CAAC;AAEvF,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACvF,OAAO,KAAK,EAAE,8BAA8B,EAAE,8BAA8B,EAAE,MAAM,iDAAiD,CAAC;AAEtI,MAAM,WAAW,6BAA6B;IAC5C,mBAAmB,EAAE,mBAAmB,GAAG,SAAS,CAAC;IACrD,QAAQ,EAAE,YAAY,CAAC;IACvB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,oBAAoB,EAAE,8BAA8B,GAAG,IAAI,CAAC;IAC5D,kBAAkB,EAAE,MAAM,CAAC;IAC3B,2BAA2B,EAAE,8BAA8B,GAAG,IAAI,CAAC;CACpE;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,6BAA6B,GAAG,GAAG,EAAE,GAAG,IAAI,CAkD9F"}

package/dist/api/turn-phases/conversation-history.js

@@ -0,0 +1,55 @@
+/**
+ * @fileoverview Conversation history assembly phase.
+ * Builds a trimmed, deduplicated history snapshot for prompt construction.
+ */
+import { MessageRole } from '../../core/conversation/ConversationMessage.js';
+import { GMIInteractionType } from '../../cognitive_substrate/IGMI.js';
+/**
+ * Build a conversation history snapshot for prompt construction.
+ * When rolling summary is active, trims history to head messages + unsummarized tail.
+ * Deduplicates the current user message if already in history.
+ */
+export function assembleConversationHistory(input) {
+    const { conversationContext } = input;
+    if (!conversationContext)
+        return null;
+    const excludeRoles = new Set([MessageRole.ERROR, MessageRole.THOUGHT]);
+    const useTrimmedHistory = input.rollingSummaryEnabled &&
+        typeof input.rollingSummaryResult?.summaryUptoTimestamp === 'number' &&
+        input.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));
+    // Deduplicate: remove the last user message if it matches the current inbound
+    const last = historyForPrompt[historyForPrompt.length - 1];
+    if (last?.role === MessageRole.USER) {
+        const content = typeof last.content === 'string' ? last.content.trim() : '';
+        const inbound = input.gmiInput.type === GMIInteractionType.TEXT && typeof input.gmiInput.content === 'string'
+            ? input.gmiInput.content.trim()
+            : input.gmiInput.type === GMIInteractionType.MULTIMODAL_CONTENT
+                ? JSON.stringify(input.gmiInput.content).trim()
+                : '';
+        if (content && inbound && content === inbound) {
+            historyForPrompt = historyForPrompt.slice(0, -1);
+        }
+    }
+    // When rolling summary is active, keep head messages + unsummarized tail
+    if (useTrimmedHistory) {
+        const headCount = Math.max(0, input.rollingSummaryConfigForTurn?.headMessagesToKeep ?? 0);
+        const head = historyForPrompt.slice(0, Math.min(headCount, historyForPrompt.length));
+        const afterSummary = historyForPrompt.filter((m) => m && m.timestamp > input.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;
+    }
+    return historyForPrompt;
+}
+//# sourceMappingURL=conversation-history.js.map

package/dist/api/turn-phases/conversation-history.js.map

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

package/dist/api/turn-phases/index.d.ts

@@ -0,0 +1,5 @@
+export * from './rolling-summary.js';
+export * from './prompt-profile.js';
+export * from './long-term-memory.js';
+export * from './conversation-history.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/turn-phases/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/turn-phases/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC"}

package/dist/api/turn-phases/index.js

@@ -0,0 +1,5 @@
+export * from './rolling-summary.js';
+export * from './prompt-profile.js';
+export * from './long-term-memory.js';
+export * from './conversation-history.js';
+//# sourceMappingURL=index.js.map

package/dist/api/turn-phases/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/turn-phases/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC"}

package/dist/api/turn-phases/long-term-memory.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @fileoverview Long-term memory retrieval phase.
+ * Checks cadence, retrieves durable memories, and updates retrieval state.
+ */
+import type { ConversationContext } from '../../core/conversation/ConversationContext';
+import type { ILongTermMemoryRetriever } from '../../core/conversation/ILongTermMemoryRetriever';
+import { type ResolvedLongTermMemoryPolicy } from '../../core/conversation/LongTermMemoryPolicy';
+import { type GMITurnInput } from '../../cognitive_substrate/IGMI';
+export interface LongTermMemoryPhaseInput {
+    conversationContext: ConversationContext | undefined;
+    longTermMemoryRetriever: ILongTermMemoryRetriever | undefined;
+    longTermMemoryPolicy: ResolvedLongTermMemoryPolicy | null;
+    gmiInput: GMITurnInput;
+    streamId: string;
+    userId: string;
+    organizationId: string | undefined;
+    conversationId: string;
+    personaId: string;
+    modeForRouting: string;
+    recallConfig: {
+        cadenceTurns: number;
+        forceOnCompaction: boolean;
+        maxContextChars: number;
+        topKByScope: Record<'user' | 'persona' | 'organization', number>;
+    };
+    didCompact: boolean;
+}
+export interface LongTermMemoryPhaseResult {
+    contextText: string | null;
+    diagnostics: Record<string, unknown> | undefined;
+    shouldReview: boolean;
+    reviewReason: string | null;
+}
+export declare function executeLongTermMemoryPhase(input: LongTermMemoryPhaseInput): Promise<LongTermMemoryPhaseResult>;
+//# sourceMappingURL=long-term-memory.d.ts.map

package/dist/api/turn-phases/long-term-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"long-term-memory.d.ts","sourceRoot":"","sources":["../../../src/api/turn-phases/long-term-memory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6CAA6C,CAAC;AACvF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kDAAkD,CAAC;AACjG,OAAO,EAEL,KAAK,4BAA4B,EAClC,MAAM,8CAA8C,CAAC;AAEtD,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAOvF,MAAM,WAAW,wBAAwB;IACvC,mBAAmB,EAAE,mBAAmB,GAAG,SAAS,CAAC;IACrD,uBAAuB,EAAE,wBAAwB,GAAG,SAAS,CAAC;IAC9D,oBAAoB,EAAE,4BAA4B,GAAG,IAAI,CAAC;IAC1D,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE;QACZ,YAAY,EAAE,MAAM,CAAC;QACrB,iBAAiB,EAAE,OAAO,CAAC;QAC3B,eAAe,EAAE,MAAM,CAAC;QACxB,WAAW,EAAE,MAAM,CAAC,MAAM,GAAG,SAAS,GAAG,cAAc,EAAE,MAAM,CAAC,CAAC;KAClE,CAAC;IACF,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACjD,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,yBAAyB,CAAC,CA+FpC"}

package/dist/api/turn-phases/long-term-memory.js

@@ -0,0 +1,82 @@
+/**
+ * @fileoverview Long-term memory retrieval phase.
+ * Checks cadence, retrieves durable memories, and updates retrieval state.
+ */
+import { DEFAULT_LONG_TERM_MEMORY_POLICY, } from '../../core/conversation/LongTermMemoryPolicy.js';
+import { MessageRole } from '../../core/conversation/ConversationMessage.js';
+import { GMIInteractionType } from '../../cognitive_substrate/IGMI.js';
+export async function executeLongTermMemoryPhase(input) {
+    const { conversationContext, longTermMemoryRetriever, longTermMemoryPolicy, } = input;
+    const policyEnabled = Boolean(longTermMemoryPolicy?.enabled);
+    const hasScopes = Boolean(longTermMemoryPolicy?.scopes?.user) ||
+        Boolean(longTermMemoryPolicy?.scopes?.persona) ||
+        Boolean(longTermMemoryPolicy?.scopes?.organization);
+    if (!conversationContext || !longTermMemoryRetriever || !policyEnabled || !hasScopes) {
+        return {
+            contextText: null,
+            diagnostics: undefined,
+            shouldReview: false,
+            reviewReason: 'retriever_not_applicable',
+        };
+    }
+    try {
+        const queryText = input.gmiInput.type === GMIInteractionType.TEXT && typeof input.gmiInput.content === 'string'
+            ? input.gmiInput.content.trim()
+            : input.gmiInput.type === GMIInteractionType.MULTIMODAL_CONTENT
+                ? JSON.stringify(input.gmiInput.content).trim()
+                : '';
+        const userTurnCount = conversationContext.getAllMessages().filter((m) => m?.role === MessageRole.USER).length;
+        const { cadenceTurns, forceOnCompaction } = input.recallConfig;
+        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 && input.didCompact;
+        const shouldReview = dueToCadence || dueToCompaction;
+        let reviewReason;
+        if (shouldReview) {
+            reviewReason = !prevState ? 'initial_review' : dueToCompaction ? 'forced_on_compaction' : 'cadence_due';
+        }
+        else {
+            reviewReason = 'cadence_not_due';
+        }
+        let contextText = null;
+        let diagnostics;
+        if (shouldReview && queryText.length > 0) {
+            const retrievalResult = await longTermMemoryRetriever.retrieveLongTermMemory({
+                userId: input.userId,
+                organizationId: input.organizationId,
+                conversationId: input.conversationId,
+                personaId: input.personaId,
+                mode: input.modeForRouting,
+                queryText,
+                memoryPolicy: longTermMemoryPolicy ?? DEFAULT_LONG_TERM_MEMORY_POLICY,
+                maxContextChars: input.recallConfig.maxContextChars,
+                topKByScope: input.recallConfig.topKByScope,
+            });
+            if (retrievalResult?.contextText?.trim()) {
+                contextText = retrievalResult.contextText.trim();
+                diagnostics = retrievalResult.diagnostics;
+            }
+            conversationContext.setMetadata('longTermMemoryRetrievalState', {
+                lastReviewedUserTurn: userTurnCount,
+                lastReviewedAt: Date.now(),
+            });
+        }
+        else if (shouldReview && queryText.length === 0) {
+            reviewReason = 'empty_query';
+        }
+        return { contextText, diagnostics, shouldReview, reviewReason };
+    }
+    catch (retrievalError) {
+        console.warn(`Long-term memory retrieval failed for stream ${input.streamId} (continuing without it).`, retrievalError);
+        return { contextText: null, diagnostics: undefined, shouldReview: true, reviewReason: 'retrieval_error' };
+    }
+}
+//# sourceMappingURL=long-term-memory.js.map