@framers/agentos 0.1.126 → 0.1.128

package/dist/api/runtime/SelfImprovementSessionManager.js

@@ -0,0 +1,330 @@
+/**
+ * @file SelfImprovementSessionManager.ts
+ * @module api/SelfImprovementSessionManager
+ *
+ * @description
+ * Manages self-improvement session runtime state: per-session skill
+ * activation/deactivation, model option overrides, user preference
+ * tracking, and prompt context generation.
+ *
+ * Previously these concerns were distributed across ~10 private methods
+ * inside `AgentOS.ts`. This extraction centralizes session-scoped
+ * self-improvement logic into a single focused class.
+ *
+ * The class also exposes a `buildToolDeps()` factory that assembles the
+ * `SelfImprovementToolDeps` closure object required by the emergent
+ * capability engine. The closures returned by `buildToolDeps()` reference
+ * runtime services lazily through callback accessors, so they resolve
+ * against the fully initialized AgentOS at tool-call time, not at
+ * bootstrap.
+ */
+import { PersonalityMutationStore } from '../../emergent/PersonalityMutationStore.js';
+import { resolveSelfImprovementSessionKey } from '../../emergent/sessionScope.js';
+import { applySelfImprovementSessionOverrides as applySessionRuntimeOverrides, buildSelfImprovementSkillPromptContext as buildSessionSkillPromptContext, buildSelfImprovementSessionRuntimeKey as buildSessionRuntimeKey, disableSelfImprovementSessionSkill as disableSessionSkill, enableSelfImprovementSessionSkill as enableSessionSkill, getSelfImprovementRuntimeParam as getSessionRuntimeParam, listSelfImprovementDisabledSkillIds as listDisabledSessionSkillIds, listSelfImprovementSessionSkills as listSessionSkills, setSelfImprovementRuntimeParam as setSessionRuntimeParam, } from './selfImprovementRuntime.js';
+function resolveSessionKey(context) {
+    return resolveSelfImprovementSessionKey((context ?? {
+        gmiId: 'self-improvement',
+        personaId: 'self-improvement',
+        userContext: { userId: 'system' },
+    }));
+}
+/**
+ * @class SelfImprovementSessionManager
+ *
+ * Owns the `selfImprovementSessionRuntime` map and exposes all session-scoped
+ * operations: key building, param get/set, skill enable/disable, override
+ * application, prompt context generation, and tool-deps factory.
+ */
+export class SelfImprovementSessionManager {
+    constructor(logger) {
+        this.logger = logger;
+        /** Per-session runtime state (model options, user prefs, skills). */
+        this.sessionRuntime = new Map();
+    }
+    // ---------------------------------------------------------------------------
+    // Configuration
+    // ---------------------------------------------------------------------------
+    /**
+     * Provide a lazy getter for the configured skill catalog. This is called
+     * once during AgentOS initialization with a closure that reads the frozen
+     * config at call time.
+     *
+     * @param getter - Callable that returns the current configured skills array.
+     */
+    setConfiguredSkillsGetter(getter) {
+        this.configuredSkillsGetter = getter;
+    }
+    // ---------------------------------------------------------------------------
+    // Session key helpers
+    // ---------------------------------------------------------------------------
+    /**
+     * Build the canonical session runtime key from a session ID.
+     *
+     * @param sessionId - The raw session identifier.
+     * @returns Normalized session key string.
+     */
+    buildSessionRuntimeKey(sessionId) {
+        return buildSessionRuntimeKey(sessionId);
+    }
+    // ---------------------------------------------------------------------------
+    // Parameter access
+    // ---------------------------------------------------------------------------
+    /**
+     * Get a runtime parameter value for a session.
+     *
+     * @param sessionKey - Canonical session key.
+     * @param param      - Parameter name.
+     * @returns The stored value, or `undefined`.
+     */
+    getRuntimeParam(sessionKey, param) {
+        return getSessionRuntimeParam(this.sessionRuntime, sessionKey, param);
+    }
+    /**
+     * Set a runtime parameter value for a session.
+     *
+     * @param sessionKey - Canonical session key.
+     * @param param      - Parameter name.
+     * @param value      - Value to store.
+     */
+    setRuntimeParam(sessionKey, param, value) {
+        setSessionRuntimeParam(this.sessionRuntime, sessionKey, param, value);
+    }
+    // ---------------------------------------------------------------------------
+    // Session overrides
+    // ---------------------------------------------------------------------------
+    /**
+     * Apply self-improvement session overrides (model options, user preferences)
+     * to an `AgentOSInput` payload.
+     *
+     * @param input - The original input.
+     * @returns A new input with merged session overrides.
+     */
+    applySessionOverrides(input) {
+        return applySessionRuntimeOverrides(this.sessionRuntime, input);
+    }
+    // ---------------------------------------------------------------------------
+    // Skill catalog
+    // ---------------------------------------------------------------------------
+    /**
+     * Return the configured discovery skills from the AgentOS config.
+     *
+     * @returns Array of configured skill descriptors.
+     */
+    getConfiguredDiscoverySkills() {
+        if (this.configuredSkillsGetter) {
+            return this.configuredSkillsGetter();
+        }
+        return [];
+    }
+    /**
+     * Normalize a partial configured skill into a full descriptor.
+     *
+     * @param skill      - Partial skill data.
+     * @param fallbackId - Optional fallback ID when none is available.
+     * @returns Normalized skill descriptor.
+     */
+    normalizeConfiguredSkill(skill, fallbackId) {
+        const skillId = String(skill.id ?? skill.name ?? fallbackId ?? 'unknown');
+        return {
+            skillId,
+            name: String(skill.name ?? fallbackId ?? skillId),
+            category: String(skill.category ?? 'general'),
+            ...(typeof skill.description === 'string' ? { description: skill.description } : {}),
+            ...(typeof skill.content === 'string' ? { content: skill.content } : {}),
+            ...(typeof skill.sourcePath === 'string' ? { sourcePath: skill.sourcePath } : {}),
+        };
+    }
+    /**
+     * Resolve a skill descriptor by ID from the configured skill catalog.
+     *
+     * @param skillId - The skill identifier to look up.
+     * @returns The resolved descriptor, or `undefined` if not found.
+     */
+    resolveConfiguredSkill(skillId) {
+        const configured = this.getConfiguredDiscoverySkills().find((skill) => String(skill.id ?? skill.name ?? '') === skillId);
+        return configured ? this.normalizeConfiguredSkill(configured, skillId) : undefined;
+    }
+    // ---------------------------------------------------------------------------
+    // Session skill management
+    // ---------------------------------------------------------------------------
+    /**
+     * List active skills for a session.
+     *
+     * @param sessionKey - Canonical session key.
+     * @returns Array of enabled skill descriptors.
+     */
+    listSessionSkills(sessionKey) {
+        return listSessionSkills(this.sessionRuntime, sessionKey);
+    }
+    /**
+     * List disabled skill IDs for a session.
+     *
+     * @param sessionKey - Canonical session key.
+     * @returns Array of disabled skill identifier strings.
+     */
+    listDisabledSkillIds(sessionKey) {
+        return listDisabledSessionSkillIds(this.sessionRuntime, sessionKey);
+    }
+    /**
+     * Build skill-related prompt context for a session.
+     *
+     * @param sessionId - The raw session identifier.
+     * @returns Prompt context string, or `undefined` when empty.
+     */
+    buildSkillPromptContext(sessionId) {
+        const sessionKey = this.buildSessionRuntimeKey(sessionId);
+        return buildSessionSkillPromptContext(this.sessionRuntime, sessionKey);
+    }
+    // ---------------------------------------------------------------------------
+    // SelfImprovementToolDeps factory
+    // ---------------------------------------------------------------------------
+    /**
+     * Build the `SelfImprovementToolDeps` closure object consumed by the
+     * emergent capability engine. All closures resolve lazily against the
+     * provided runtime accessors.
+     *
+     * @param storageAdapter - Optional storage adapter for the personality mutation store.
+     * @param accessors      - Lazy runtime service accessors.
+     * @returns Assembled `SelfImprovementToolDeps`, or `undefined` when no
+     *          storage adapter or accessors are available.
+     */
+    buildToolDeps(storageAdapter, accessors) {
+        const mutationStore = storageAdapter
+            ? new PersonalityMutationStore({
+                run: async (sql, params) => storageAdapter.run(sql, params),
+                get: async (sql, params) => storageAdapter.get(sql, params),
+                all: async (sql, params) => storageAdapter.all(sql, params),
+                exec: async (sql) => storageAdapter.exec(sql),
+            })
+            : undefined;
+        return {
+            // --- Personality (HEXACO) ---
+            getPersonality: () => {
+                try {
+                    const gmi = accessors.getActiveGMI();
+                    const traits = gmi?.getPersona()?.personalityTraits;
+                    if (traits && typeof traits === 'object') {
+                        const result = {};
+                        for (const [k, v] of Object.entries(traits)) {
+                            if (typeof v === 'number')
+                                result[k] = v;
+                        }
+                        return result;
+                    }
+                }
+                catch { /* GMI not ready yet — return empty. */ }
+                return {};
+            },
+            setPersonality: (trait, value) => {
+                try {
+                    const gmi = accessors.getActiveGMI();
+                    const persona = gmi?.getPersona();
+                    if (persona) {
+                        if (!persona.personalityTraits) {
+                            persona.personalityTraits = {};
+                        }
+                        persona.personalityTraits[trait] = value;
+                    }
+                }
+                catch { /* GMI not ready — ignore. */ }
+            },
+            mutationStore,
+            // --- Skills ---
+            getActiveSkills: (context) => {
+                const sessionKey = resolveSessionKey(context);
+                return this.listSessionSkills(sessionKey).map((skill) => ({
+                    skillId: skill.skillId,
+                    name: skill.name,
+                    category: skill.category,
+                }));
+            },
+            getLockedSkills: () => [],
+            loadSkill: async (id, context) => {
+                const sessionKey = resolveSessionKey(context);
+                const resolvedSkill = this.resolveConfiguredSkill(id) ?? {
+                    skillId: id,
+                    name: id,
+                    category: 'dynamic',
+                };
+                enableSessionSkill(this.sessionRuntime, sessionKey, resolvedSkill);
+                return {
+                    skillId: resolvedSkill.skillId,
+                    name: resolvedSkill.name,
+                    category: resolvedSkill.category,
+                };
+            },
+            unloadSkill: (id, context) => {
+                const sessionKey = resolveSessionKey(context);
+                const resolvedSkill = this.resolveConfiguredSkill(id);
+                disableSessionSkill(this.sessionRuntime, sessionKey, resolvedSkill?.name ?? id);
+            },
+            searchSkills: (query) => {
+                const q = query.toLowerCase();
+                return this.getConfiguredDiscoverySkills()
+                    .filter((skill) => (skill.name ?? '').toLowerCase().includes(q) ||
+                    (skill.description ?? '').toLowerCase().includes(q))
+                    .map((skill) => {
+                    const normalizedSkill = this.normalizeConfiguredSkill(skill);
+                    return {
+                        skillId: normalizedSkill.skillId,
+                        name: normalizedSkill.name,
+                        category: normalizedSkill.category,
+                        description: normalizedSkill.description ?? '',
+                    };
+                });
+            },
+            // --- Tools ---
+            executeTool: async (name, args, context) => {
+                const orchestrator = accessors.getToolOrchestrator();
+                const tool = await orchestrator.getTool(name);
+                if (!tool) {
+                    throw new Error(`Tool "${name}" not found in orchestrator.`);
+                }
+                const result = await tool.execute((args ?? {}), context ?? {
+                    gmiId: 'self-improvement',
+                    personaId: 'self-improvement',
+                    userContext: { userId: 'system' },
+                });
+                if (!result.success) {
+                    throw new Error(result.error ?? `Tool "${name}" failed.`);
+                }
+                return result.output;
+            },
+            listTools: () => {
+                try {
+                    const orchestrator = accessors.getToolOrchestrator();
+                    return orchestrator.toolExecutor
+                        ?.listAvailableTools()
+                        ?.map((t) => t.name) ?? [];
+                }
+                catch {
+                    return [];
+                }
+            },
+            getSessionParam: (param, context) => {
+                const sessionKey = resolveSessionKey(context);
+                return this.getRuntimeParam(sessionKey, param);
+            },
+            setSessionParam: (param, value, context) => {
+                const sessionKey = resolveSessionKey(context);
+                this.setRuntimeParam(sessionKey, param, value);
+            },
+            // --- Memory ---
+            storeMemory: async (trace) => {
+                try {
+                    const gmi = accessors.getActiveGMI();
+                    const mem = gmi?.getCognitiveMemoryManager?.();
+                    if (mem) {
+                        await mem.encode(`[self-improvement:${trace.type}] ${trace.content}`, { valence: 0, arousal: 0, dominance: 0.5 }, 'neutral', {
+                            type: 'semantic',
+                            scope: (trace.scope ?? 'agent'),
+                            tags: trace.tags,
+                        });
+                    }
+                }
+                catch { /* Memory not available — silently skip. */ }
+            },
+        };
+    }
+}
+//# sourceMappingURL=SelfImprovementSessionManager.js.map

package/dist/api/runtime/SelfImprovementSessionManager.js.map

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

package/dist/api/runtime/StreamChunkEmitter.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @fileoverview Stream chunk assembly and emission delegate.
+ * Extracted from AgentOSOrchestrator for focused chunk construction logic.
+ */
+import type { StreamId, StreamingManager } from '../../core/streaming/StreamingManager';
+import { AgentOSResponseChunkType } from '../types/AgentOSResponse';
+import { GMIErrorCode } from '../../core/utils/errors';
+type TurnExecutionLifecyclePhase = 'planned' | 'executing' | 'degraded' | 'recovered' | 'completed' | 'errored';
+interface StreamContext {
+    languageNegotiation?: any;
+}
+/**
+ * Assembles and emits AgentOS response chunks via a StreamingManager.
+ * Takes a reference to the active stream contexts map for language negotiation metadata.
+ */
+export declare class StreamChunkEmitter {
+    private readonly streamingManager;
+    private readonly activeStreamContexts;
+    constructor(streamingManager: StreamingManager, activeStreamContexts: Map<string, StreamContext>);
+    pushChunk(streamId: StreamId, type: AgentOSResponseChunkType, gmiInstanceId: string, personaId: string, isFinal: boolean, data: any): Promise<void>;
+    pushError(streamId: StreamId, personaId: string, gmiInstanceId: string | undefined, code: GMIErrorCode | string, message: string, details?: any): Promise<void>;
+    emitLifecycleUpdate(args: {
+        streamId: StreamId;
+        gmiInstanceId: string;
+        personaId: string;
+        phase: TurnExecutionLifecyclePhase;
+        status: 'ok' | 'degraded' | 'error';
+        details?: Record<string, unknown>;
+    }): Promise<void>;
+}
+export {};
+//# sourceMappingURL=StreamChunkEmitter.d.ts.map

package/dist/api/runtime/StreamChunkEmitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StreamChunkEmitter.d.ts","sourceRoot":"","sources":["../../../src/api/runtime/StreamChunkEmitter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AACxF,OAAO,EAEL,wBAAwB,EAUzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAOlE,KAAK,2BAA2B,GAC5B,SAAS,GACT,WAAW,GACX,UAAU,GACV,WAAW,GACX,WAAW,GACX,SAAS,CAAC;AAEd,UAAU,aAAa;IACrB,mBAAmB,CAAC,EAAE,GAAG,CAAC;CAC3B;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IAE3B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,oBAAoB;gBADpB,gBAAgB,EAAE,gBAAgB,EAClC,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC;IAG7D,SAAS,CACb,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,wBAAwB,EAC9B,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,GAAG,GACR,OAAO,CAAC,IAAI,CAAC;IAsHV,SAAS,CACb,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,YAAyB,EAC9C,IAAI,EAAE,YAAY,GAAG,MAAM,EAC3B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,GAAG,GACZ,OAAO,CAAC,IAAI,CAAC;IAWV,mBAAmB,CAAC,IAAI,EAAE;QAC9B,QAAQ,EAAE,QAAQ,CAAC;QACnB,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,2BAA2B,CAAC;QACnC,MAAM,EAAE,IAAI,GAAG,UAAU,GAAG,OAAO,CAAC;QACpC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,GAAG,OAAO,CAAC,IAAI,CAAC;CAmBlB"}

package/dist/api/runtime/StreamChunkEmitter.js

@@ -0,0 +1,143 @@
+/**
+ * @fileoverview Stream chunk assembly and emission delegate.
+ * Extracted from AgentOSOrchestrator for focused chunk construction logic.
+ */
+import { AgentOSResponseChunkType, } from '../types/AgentOSResponse.js';
+import { GMIErrorCode } from '../../core/utils/errors.js';
+import { normalizeUsage } from '../../orchestration/turn-planner/helpers.js';
+import { getActiveTraceMetadata, shouldIncludeTraceInAgentOSResponses, } from '../../evaluation/observability/otel.js';
+/**
+ * Assembles and emits AgentOS response chunks via a StreamingManager.
+ * Takes a reference to the active stream contexts map for language negotiation metadata.
+ */
+export class StreamChunkEmitter {
+    constructor(streamingManager, activeStreamContexts) {
+        this.streamingManager = streamingManager;
+        this.activeStreamContexts = activeStreamContexts;
+    }
+    async pushChunk(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,
+                    executionMode: data.executionMode,
+                    requiresExternalToolResult: data.requiresExternalToolResult,
+                };
+                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(`StreamChunkEmitter: Unknown chunk type: ${type}`);
+                chunk = {
+                    ...baseChunk,
+                    type: AgentOSResponseChunkType.ERROR,
+                    code: GMIErrorCode.INTERNAL_SERVER_ERROR,
+                    message: `Unknown chunk type: ${type}`,
+                    details: data,
+                };
+        }
+        try {
+            await this.streamingManager.pushChunk(streamId, chunk);
+        }
+        catch (pushError) {
+            console.error(`StreamChunkEmitter: Failed to push chunk to stream ${streamId}. Type: ${type}. Error: ${pushError?.message}`, pushError);
+        }
+    }
+    async pushError(streamId, personaId, gmiInstanceId = 'unknown_gmi_instance', code, message, details) {
+        await this.pushChunk(streamId, AgentOSResponseChunkType.ERROR, gmiInstanceId, personaId, true, { code: code.toString(), message, details });
+    }
+    async emitLifecycleUpdate(args) {
+        await this.pushChunk(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),
+                },
+            },
+        });
+    }
+}
+//# sourceMappingURL=StreamChunkEmitter.js.map

package/dist/api/runtime/StreamChunkEmitter.js.map

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

package/dist/api/runtime/TaskOutcomeTelemetryManager.d.ts

@@ -0,0 +1,107 @@
+/**
+ * @fileoverview Task outcome telemetry — rolling KPI windows, adaptive execution,
+ * and alert generation. Extracted from AgentOSOrchestrator for readability.
+ */
+import type { GMIOutput } from '../../cognitive_substrate/IGMI';
+import type { TaskOutcomeTelemetryScope, AgentOSTaskOutcomeTelemetryConfig, AgentOSAdaptiveExecutionConfig, TaskOutcomeKpiWindowEntry, ITaskOutcomeTelemetryStore } from '../types/OrchestratorConfig';
+import type { TurnPlan } from '../../orchestration/turn-planner/TurnPlanner';
+type TaskOutcomeStatus = 'success' | 'partial' | 'failed';
+export type TaskOutcomeAssessment = {
+    status: TaskOutcomeStatus;
+    score: number;
+    reason: string;
+    source: 'heuristic' | 'request_override';
+};
+export type TaskOutcomeKpiSummary = {
+    scopeKey: string;
+    scopeMode: TaskOutcomeTelemetryScope;
+    windowSize: number;
+    sampleCount: number;
+    successCount: number;
+    partialCount: number;
+    failedCount: number;
+    successRate: number;
+    averageScore: number;
+    weightedSuccessRate: number;
+    timestamp: string;
+};
+export type TaskOutcomeKpiAlert = {
+    scopeKey: string;
+    severity: 'warning' | 'critical';
+    reason: string;
+    threshold: number;
+    value: number;
+    sampleCount: number;
+    timestamp: string;
+};
+export type AdaptiveExecutionDecision = {
+    applied: boolean;
+    reason?: string;
+    kpi?: TaskOutcomeKpiSummary | null;
+    actions?: {
+        forcedToolSelectionMode?: boolean;
+        forcedToolFailureMode?: boolean;
+        preservedRequestedFailClosed?: boolean;
+    };
+};
+export type ResolvedTaskOutcomeTelemetryConfig = {
+    enabled: boolean;
+    rollingWindowSize: number;
+    scope: TaskOutcomeTelemetryScope;
+    emitAlerts: boolean;
+    alertBelowWeightedSuccessRate: number;
+    alertMinSamples: number;
+    alertCooldownMs: number;
+};
+export type ResolvedAdaptiveExecutionConfig = {
+    enabled: boolean;
+    minSamples: number;
+    minWeightedSuccessRate: number;
+    forceAllToolsWhenDegraded: boolean;
+    forceFailOpenWhenDegraded: boolean;
+};
+export declare function resolveTaskOutcomeTelemetryConfig(config: AgentOSTaskOutcomeTelemetryConfig | undefined): ResolvedTaskOutcomeTelemetryConfig;
+export declare function resolveAdaptiveExecutionConfig(config: AgentOSAdaptiveExecutionConfig | undefined): ResolvedAdaptiveExecutionConfig;
+export declare function sanitizeKpiEntry(raw: any): TaskOutcomeKpiWindowEntry | null;
+export declare function evaluateTaskOutcome(args: {
+    finalOutput: GMIOutput;
+    didForceTerminate: boolean;
+    degraded: boolean;
+    customFlags?: Record<string, any>;
+}): TaskOutcomeAssessment;
+/**
+ * Manages rolling task outcome KPI windows, adaptive execution policies,
+ * and alert generation. Designed to be used as a delegate within AgentOSOrchestrator.
+ */
+export declare class TaskOutcomeTelemetryManager {
+    private readonly telemetryConfig;
+    private readonly adaptiveConfig;
+    private readonly store?;
+    readonly kpiWindows: Map<string, TaskOutcomeKpiWindowEntry[]>;
+    readonly alertState: Map<string, number>;
+    constructor(telemetryConfig: ResolvedTaskOutcomeTelemetryConfig, adaptiveConfig: ResolvedAdaptiveExecutionConfig, store?: ITaskOutcomeTelemetryStore | undefined);
+    loadPersistedWindows(): Promise<void>;
+    resolveScopeKey(args: {
+        organizationId?: string;
+        personaId?: string;
+    }): string;
+    updateKpi(args: {
+        outcome: TaskOutcomeAssessment;
+        organizationId?: string;
+        personaId?: string;
+    }): TaskOutcomeKpiSummary | null;
+    getCurrentKpi(args: {
+        organizationId?: string;
+        personaId?: string;
+    }): TaskOutcomeKpiSummary | null;
+    summarizeWindow(scopeKey: string): TaskOutcomeKpiSummary | null;
+    maybeApplyAdaptivePolicy(args: {
+        turnPlan: TurnPlan | null;
+        organizationId?: string;
+        personaId?: string;
+        requestCustomFlags?: Record<string, any>;
+    }): AdaptiveExecutionDecision;
+    maybeBuildAlert(kpi: TaskOutcomeKpiSummary | null): TaskOutcomeKpiAlert | null;
+}
+export {};
+//# sourceMappingURL=TaskOutcomeTelemetryManager.d.ts.map

package/dist/api/runtime/TaskOutcomeTelemetryManager.d.ts.map

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