@rlynjb/aptkit-core 0.1.0

package/README.md

@@ -0,0 +1,19 @@
+# @rlynjb/aptkit-core
+
+Umbrella package for the stable AptKit recommendation slice.
+
+This package re-exports the runtime, tool, context, prompt, eval, and recommendation-agent APIs that are ready to consume from another app.
+
+Use focused packages directly when you want a smaller dependency surface. Use this package when you want a single package install while the library boundary is still evolving.
+
+## npm
+
+The package is published to npmjs as `@rlynjb/aptkit-core`.
+
+Blooming keeps its existing imports by installing this package through an npm alias:
+
+```sh
+npm install @aptkit/core@npm:@rlynjb/aptkit-core@0.1.0
+```
+
+Because the package is public on npmjs, consumers do not need a package registry token.

package/dist/src/index.d.ts

@@ -0,0 +1,12 @@
+export * from '@aptkit/runtime';
+export * from '@aptkit/tools';
+export * from '@aptkit/context';
+export * from '@aptkit/prompts';
+export * from '@aptkit/evals';
+export * from '@aptkit/agent-recommendation';
+export { ANOMALY_MONITORING_CAPABILITY_ID, AnomalyMonitoringAgent, ECOMMERCE_ANOMALY_CATEGORIES, anomalyMonitoringToolPolicy, coverageReport, formatCategoryChecklist, runnableCategories, schemaCapabilities, tryParseAnomalies, validateAnomalies, } from '@aptkit/agent-anomaly-monitoring';
+export type { Anomaly as MonitoringAnomaly, AnomalyCategory as MonitoringAnomalyCategory, } from '@aptkit/agent-anomaly-monitoring';
+export { DIAGNOSTIC_INVESTIGATION_CAPABILITY_ID, DiagnosticInvestigationAgent, diagnosticInvestigationToolPolicy, diagnosisConfidence, tryParseDiagnosis, validateDiagnosis, } from '@aptkit/agent-diagnostic-investigation';
+export type { Anomaly as DiagnosticAnomaly, Diagnosis as DiagnosticDiagnosis, } from '@aptkit/agent-diagnostic-investigation';
+export { QUERY_CAPABILITY_ID, QueryAgent, classifyIntent, parseIntent, queryToolPolicy, validateQueryAnswer, } from '@aptkit/agent-query';
+export type { Intent as QueryIntent, QueryAnswer, } from '@aptkit/agent-query';

package/dist/src/index.js

@@ -0,0 +1,9 @@
+export * from '@aptkit/runtime';
+export * from '@aptkit/tools';
+export * from '@aptkit/context';
+export * from '@aptkit/prompts';
+export * from '@aptkit/evals';
+export * from '@aptkit/agent-recommendation';
+export { ANOMALY_MONITORING_CAPABILITY_ID, AnomalyMonitoringAgent, ECOMMERCE_ANOMALY_CATEGORIES, anomalyMonitoringToolPolicy, coverageReport, formatCategoryChecklist, runnableCategories, schemaCapabilities, tryParseAnomalies, validateAnomalies, } from '@aptkit/agent-anomaly-monitoring';
+export { DIAGNOSTIC_INVESTIGATION_CAPABILITY_ID, DiagnosticInvestigationAgent, diagnosticInvestigationToolPolicy, diagnosisConfidence, tryParseDiagnosis, validateDiagnosis, } from '@aptkit/agent-diagnostic-investigation';
+export { QUERY_CAPABILITY_ID, QueryAgent, classifyIntent, parseIntent, queryToolPolicy, validateQueryAnswer, } from '@aptkit/agent-query';

package/node_modules/@aptkit/agent-anomaly-monitoring/README.md

@@ -0,0 +1,13 @@
+# @aptkit/agent-anomaly-monitoring
+
+Extracted anomaly-monitoring capability based on the Blooming Insights monitoring agent.
+
+This package contains:
+
+- `AnomalyMonitoringAgent`: bounded model/tool loop for anomaly detection.
+- Ecommerce category coverage gating.
+- Workspace schema summarization.
+- Anomaly output validation.
+- Fixture replay with fake tools and fake model responses.
+
+The package is app-agnostic: host apps provide a `ModelProvider`, `ToolRegistry`, and `WorkspaceDescriptor`.

package/node_modules/@aptkit/agent-anomaly-monitoring/dist/src/categories.d.ts

@@ -0,0 +1,11 @@
+import { missingCapabilities, schemaCapabilities } from '@aptkit/tools';
+import type { AnomalyCategory, CategoryCoverage, CategoryCoverageItem } from './types.js';
+export { missingCapabilities, schemaCapabilities };
+/** Ecommerce-specific anomaly checks used by the monitoring agent's default category pack. */
+export declare const ECOMMERCE_ANOMALY_CATEGORIES: AnomalyCategory[];
+/** Compatibility wrapper for generic coverage classification from @aptkit/tools. */
+export declare function categoryCoverage(category: AnomalyCategory, capabilities: Set<string>): CategoryCoverage;
+/** Reports which ecommerce anomaly categories are runnable for the supplied workspace capabilities. */
+export declare function coverageReport(categories: readonly AnomalyCategory[], capabilities: Set<string>): CategoryCoverageItem[];
+/** Filters the default or supplied categories before the monitoring agent calls a model. */
+export declare function runnableCategories(categories: readonly AnomalyCategory[], capabilities: Set<string>): AnomalyCategory[];

package/node_modules/@aptkit/agent-anomaly-monitoring/dist/src/categories.js

@@ -0,0 +1,100 @@
+import { coverageReport as baseCoverageReport, missingCapabilities, requirementCoverage, runnableRequirements, schemaCapabilities, } from '@aptkit/tools';
+export { missingCapabilities, schemaCapabilities };
+const windowText = 'in last 90 days';
+/** Ecommerce-specific anomaly checks used by the monitoring agent's default category pack. */
+export const ECOMMERCE_ANOMALY_CATEGORIES = [
+    {
+        id: 'conversion_drop',
+        label: 'conversion rate drop',
+        requires: ['view_item', 'checkout', 'purchase'],
+        whyItMatters: 'conversion is the funnel hinge; a drop here loses completed-intent customers even at flat traffic.',
+        queryRecipe: `select count event view_item, count event checkout, count event purchase ${windowText}`,
+        thresholds: { critical: 20, warning: 10 },
+    },
+    {
+        id: 'cart_abandonment',
+        label: 'cart abandonment',
+        requires: ['cart_update', 'checkout', 'purchase'],
+        whyItMatters: 'rising abandonment means shoppers fill carts but stall before paying.',
+        queryRecipe: `select count event cart_update, count event checkout, count event purchase ${windowText}`,
+        thresholds: { critical: 20, warning: 10 },
+    },
+    {
+        id: 'product_demand',
+        label: 'product demand spike',
+        requires: ['purchase'],
+        whyItMatters: 'a sudden SKU or category velocity spike is an opportunity to protect stock and ride demand.',
+        queryRecipe: `select count event purchase by event purchase.product_id grouping top 10 ${windowText}`,
+        thresholds: { critical: 100, warning: 50 },
+    },
+    {
+        id: 'revenue_drop',
+        label: 'revenue drop',
+        requires: ['purchase'],
+        whyItMatters: 'revenue moves flow directly to income; isolate whether the move is demand or conversion.',
+        queryRecipe: `select sum event purchase.total_price, count event purchase ${windowText}`,
+        thresholds: { critical: 20, warning: 10 },
+    },
+    {
+        id: 'customer_churn',
+        label: 'customer churn',
+        requires: ['purchase', 'session_start'],
+        whyItMatters: 'falling repeat purchase reflects customers not coming back.',
+        queryRecipe: `select count event purchase, count event session_start ${windowText}`,
+        thresholds: { critical: 15, warning: 8 },
+    },
+    {
+        id: 'inventory',
+        label: 'inventory problems',
+        requires: ['purchase'],
+        enriches: ['catalog:inventory_level'],
+        whyItMatters: 'sell-through outrunning replenishment creates stockouts and lost sales.',
+        queryRecipe: `select count event purchase by event purchase.product_id grouping top 10 ${windowText}`,
+        thresholds: { critical: 30, warning: 15 },
+    },
+    {
+        id: 'campaign_perf',
+        label: 'campaign performance',
+        requires: ['session_start'],
+        enriches: ['session_start.utm_source'],
+        whyItMatters: 'campaign traffic swings move the top of the funnel.',
+        queryRecipe: `select count event session_start ${windowText}`,
+        thresholds: { critical: 25, warning: 12 },
+    },
+    {
+        id: 'search_failure',
+        label: 'search failure',
+        requires: ['search'],
+        whyItMatters: 'zero-result searches are demand the catalog or relevance is failing to meet.',
+        queryRecipe: `select count event search ${windowText}`,
+        thresholds: { critical: 20, warning: 10 },
+    },
+    {
+        id: 'return_spike',
+        label: 'product return spike',
+        requires: ['return'],
+        whyItMatters: 'return spikes point at quality, sizing, or expectation gaps.',
+        queryRecipe: `select count event return ${windowText}`,
+        thresholds: { critical: 25, warning: 12 },
+    },
+    {
+        id: 'fraud',
+        label: 'fraud detection',
+        requires: ['payment_failure'],
+        whyItMatters: 'clusters of failed payments or anomalous orders can signal card testing or fraud.',
+        queryRecipe: `select count event payment_failure ${windowText}`,
+        thresholds: { critical: 20, warning: 10 },
+    },
+];
+/** Compatibility wrapper for generic coverage classification from @aptkit/tools. */
+export function categoryCoverage(category, capabilities) {
+    return requirementCoverage(category, capabilities);
+}
+/** Reports which ecommerce anomaly categories are runnable for the supplied workspace capabilities. */
+export function coverageReport(categories, capabilities) {
+    return baseCoverageReport(categories, capabilities);
+}
+/** Filters the default or supplied categories before the monitoring agent calls a model. */
+export function runnableCategories(categories, capabilities) {
+    return runnableRequirements(categories, capabilities);
+}

package/node_modules/@aptkit/agent-anomaly-monitoring/dist/src/fixture-provider.d.ts

@@ -0,0 +1,10 @@
+import type { ModelProvider, ModelRequest, ModelResponse } from '@aptkit/runtime';
+export declare class FixtureModelProvider implements ModelProvider {
+    private readonly responses;
+    readonly id = "fixture";
+    readonly defaultModel = "fixture-model";
+    readonly requests: ModelRequest[];
+    private index;
+    constructor(responses: ModelResponse[]);
+    complete(request: ModelRequest): Promise<ModelResponse>;
+}

package/node_modules/@aptkit/agent-anomaly-monitoring/dist/src/fixture-provider.js

@@ -0,0 +1,18 @@
+export class FixtureModelProvider {
+    responses;
+    id = 'fixture';
+    defaultModel = 'fixture-model';
+    requests = [];
+    index = 0;
+    constructor(responses) {
+        this.responses = responses;
+    }
+    async complete(request) {
+        this.requests.push(request);
+        const response = this.responses[this.index];
+        this.index += 1;
+        if (!response)
+            throw new Error(`fixture model exhausted after ${this.index - 1} responses`);
+        return response;
+    }
+}

package/node_modules/@aptkit/agent-anomaly-monitoring/dist/src/index.d.ts

@@ -0,0 +1,6 @@
+export * from './monitoring-agent.js';
+export * from './types.js';
+export * from './categories.js';
+export * from './fixture-provider.js';
+export * from './schema-summary.js';
+export * from './validate.js';

package/node_modules/@aptkit/agent-anomaly-monitoring/dist/src/index.js

@@ -0,0 +1,6 @@
+export * from './monitoring-agent.js';
+export * from './types.js';
+export * from './categories.js';
+export * from './fixture-provider.js';
+export * from './schema-summary.js';
+export * from './validate.js';

package/node_modules/@aptkit/agent-anomaly-monitoring/dist/src/monitoring-agent.d.ts

@@ -0,0 +1,32 @@
+import { type CapabilityTraceSink, type ModelProvider } from '@aptkit/runtime';
+import { type ToolRegistry } from '@aptkit/tools';
+import type { Anomaly, AnomalyCategory, WorkspaceDescriptor } from './types.js';
+export declare const ANOMALY_MONITORING_CAPABILITY_ID = "anomaly-monitoring-agent";
+/** Least-privilege tool grant for anomaly scanning. Provider adapters only see these tools. */
+export declare const anomalyMonitoringToolPolicy: {
+    capabilityId: string;
+    allowedTools: readonly ["execute_analytics_eql", "get_metric_timeseries", "get_segments", "get_anomaly_context"];
+};
+export type MonitoringAgentOptions = {
+    model: ModelProvider;
+    tools: ToolRegistry;
+    workspace: WorkspaceDescriptor;
+    categories?: readonly AnomalyCategory[];
+    trace?: CapabilityTraceSink;
+    prompt?: string;
+};
+export type MonitoringRunOptions = {
+    signal?: AbortSignal;
+};
+export declare class AnomalyMonitoringAgent {
+    private readonly options;
+    private readonly categories;
+    private readonly prompt;
+    constructor(options: MonitoringAgentOptions);
+    /** Returns categories this workspace can scan without asking the model to guess unsupported work. */
+    runnableCategories(): AnomalyCategory[];
+    /** Runs a bounded anomaly scan and returns validated, severity-sorted anomaly objects. */
+    scan(runOptions?: MonitoringRunOptions): Promise<Anomaly[]>;
+}
+/** Formats runnable categories for the system prompt shown to the model. */
+export declare function formatCategoryChecklist(categories: readonly AnomalyCategory[]): string;

package/node_modules/@aptkit/agent-anomaly-monitoring/dist/src/monitoring-agent.js

@@ -0,0 +1,88 @@
+import { monitoringPromptPackage, renderPromptTemplate } from '@aptkit/prompts';
+import { buildSynthesisInstruction, runAgentLoop } from '@aptkit/runtime';
+import { filterToolsForPolicy } from '@aptkit/tools';
+import { ECOMMERCE_ANOMALY_CATEGORIES, runnableCategories, schemaCapabilities } from './categories.js';
+import { schemaSummary } from './schema-summary.js';
+import { tryParseAnomalies } from './validate.js';
+export const ANOMALY_MONITORING_CAPABILITY_ID = 'anomaly-monitoring-agent';
+/** Least-privilege tool grant for anomaly scanning. Provider adapters only see these tools. */
+export const anomalyMonitoringToolPolicy = {
+    capabilityId: ANOMALY_MONITORING_CAPABILITY_ID,
+    allowedTools: [
+        'execute_analytics_eql',
+        'get_metric_timeseries',
+        'get_segments',
+        'get_anomaly_context',
+    ],
+};
+const severityRank = {
+    critical: 3,
+    warning: 2,
+    info: 1,
+    positive: 0,
+};
+export class AnomalyMonitoringAgent {
+    options;
+    categories;
+    prompt;
+    constructor(options) {
+        this.options = options;
+        this.categories = options.categories ?? ECOMMERCE_ANOMALY_CATEGORIES;
+        this.prompt = options.prompt ?? monitoringPromptPackage.system;
+    }
+    /** Returns categories this workspace can scan without asking the model to guess unsupported work. */
+    runnableCategories() {
+        return runnableCategories(this.categories, schemaCapabilities(this.options.workspace));
+    }
+    /** Runs a bounded anomaly scan and returns validated, severity-sorted anomaly objects. */
+    async scan(runOptions = {}) {
+        const allTools = await this.options.tools.listTools();
+        const toolSchemas = filterToolsForPolicy(allTools, anomalyMonitoringToolPolicy);
+        const categories = this.runnableCategories();
+        const system = renderPromptTemplate(this.prompt, {
+            schema: schemaSummary(this.options.workspace),
+            categories: formatCategoryChecklist(categories),
+        });
+        const { parsed } = await runAgentLoop({
+            capabilityId: ANOMALY_MONITORING_CAPABILITY_ID,
+            model: this.options.model,
+            tools: this.options.tools,
+            system,
+            userPrompt: 'Run the anomaly checklist using the available tools. Return only the anomaly JSON array in a json fence, or [] if no meaningful anomaly is found.',
+            toolSchemas,
+            trace: this.options.trace,
+            signal: runOptions.signal,
+            maxTurns: 8,
+            maxToolCalls: 6,
+            synthesisInstruction: buildSynthesisInstruction('Stop querying now and output your final answer. Respond with ONLY a JSON array of anomaly objects in a json fence, or [] if nothing meaningful was found, based on the data you have already gathered.'),
+            parseResult: tryParseAnomalies,
+            recoveryPrompt: buildRecoveryPrompt,
+        });
+        if (!parsed)
+            return [];
+        return [...parsed]
+            .sort((left, right) => severityRank[right.severity] - severityRank[left.severity])
+            .slice(0, 10);
+    }
+}
+/** Formats runnable categories for the system prompt shown to the model. */
+export function formatCategoryChecklist(categories) {
+    if (categories.length === 0)
+        return '(no runnable checklist categories; scan core metrics broadly)';
+    return categories
+        .map((category) => `- ${category.id} (${category.label}): ${category.whyItMatters} recipe: ${category.queryRecipe}; warning >= ${category.thresholds.warning}%, critical >= ${category.thresholds.critical}%.`)
+        .join('\n');
+}
+function buildRecoveryPrompt(toolCalls) {
+    const evidence = toolCalls
+        .map((call, index) => {
+        const payload = call.error ? { error: call.error } : call.result;
+        return `Query ${index + 1}: ${call.toolName} ${JSON.stringify(call.args).slice(0, 200)}\nResult: ${JSON.stringify(payload).slice(0, 900)}`;
+    })
+        .join('\n\n') || '(no tool queries were completed)';
+    return [
+        'The anomaly-monitoring run is complete. Convert the evidence below into the final anomaly JSON array.',
+        evidence,
+        'Return ONLY a JSON array in a json fence. Each anomaly needs metric, scope, change, severity, evidence, and category when known. Return [] if evidence is not strong enough.',
+    ].join('\n\n');
+}

package/node_modules/@aptkit/agent-anomaly-monitoring/dist/src/schema-summary.d.ts

@@ -0,0 +1,2 @@
+import type { WorkspaceDescriptor } from './types.js';
+export declare function schemaSummary(workspace: WorkspaceDescriptor): string;

package/node_modules/@aptkit/agent-anomaly-monitoring/dist/src/schema-summary.js

@@ -0,0 +1,7 @@
+import { schemaSummary as baseSchemaSummary } from '@aptkit/context';
+export function schemaSummary(workspace) {
+    return baseSchemaSummary(workspace, {
+        horizonStyle: 'plain',
+        eventHeading: 'Top events:',
+    });
+}

package/node_modules/@aptkit/agent-anomaly-monitoring/dist/src/types.d.ts

@@ -0,0 +1,32 @@
+export type { WorkspaceDescriptor } from '@aptkit/context';
+export type { CoverageLevel as CategoryCoverage, CoverageReportItem as CategoryCoverageItem, CoverageRequirement, } from '@aptkit/tools';
+export type Severity = 'critical' | 'warning' | 'info' | 'positive';
+export type AnomalyCategory = {
+    id: string;
+    label: string;
+    requires: readonly string[];
+    enriches?: readonly string[];
+    whyItMatters: string;
+    queryRecipe: string;
+    thresholds: {
+        critical: number;
+        warning: number;
+    };
+};
+export type Anomaly = {
+    metric: string;
+    scope: string[];
+    change: {
+        value: number;
+        direction: 'up' | 'down';
+        baseline: string;
+    };
+    severity: Severity;
+    evidence: {
+        tool: string;
+        result: unknown;
+    }[];
+    impact?: string;
+    history?: number[];
+    category?: string;
+};

package/node_modules/@aptkit/agent-anomaly-monitoring/dist/src/types.js

@@ -0,0 +1 @@
+export {};

package/node_modules/@aptkit/agent-anomaly-monitoring/dist/src/validate.d.ts

@@ -0,0 +1,9 @@
+import type { Anomaly } from './types.js';
+export declare function validateAnomalies(value: unknown): {
+    ok: true;
+    value: Anomaly[];
+} | {
+    ok: false;
+    error: string;
+};
+export declare function tryParseAnomalies(text: string): Anomaly[] | null;

package/node_modules/@aptkit/agent-anomaly-monitoring/dist/src/validate.js

@@ -0,0 +1,34 @@
+import { parseValidatedJson } from '@aptkit/runtime';
+const severities = ['critical', 'warning', 'info', 'positive'];
+export function validateAnomalies(value) {
+    if (!Array.isArray(value))
+        return { ok: false, error: 'expected anomaly array' };
+    for (const [index, anomaly] of value.entries()) {
+        if (!anomaly || typeof anomaly !== 'object')
+            return { ok: false, error: `${index}: expected object` };
+        const candidate = anomaly;
+        if (typeof candidate.metric !== 'string')
+            return { ok: false, error: `${index}.metric must be string` };
+        if (!Array.isArray(candidate.scope) || !candidate.scope.every((item) => typeof item === 'string')) {
+            return { ok: false, error: `${index}.scope must be string[]` };
+        }
+        if (!candidate.change || typeof candidate.change !== 'object')
+            return { ok: false, error: `${index}.change must be object` };
+        const change = candidate.change;
+        if (typeof change.value !== 'number')
+            return { ok: false, error: `${index}.change.value must be number` };
+        if (change.direction !== 'up' && change.direction !== 'down')
+            return { ok: false, error: `${index}.change.direction invalid` };
+        if (typeof change.baseline !== 'string')
+            return { ok: false, error: `${index}.change.baseline must be string` };
+        if (!severities.includes(candidate.severity))
+            return { ok: false, error: `${index}.severity invalid` };
+        if ('evidence' in candidate && !Array.isArray(candidate.evidence))
+            return { ok: false, error: `${index}.evidence must be array` };
+    }
+    return { ok: true, value: value };
+}
+export function tryParseAnomalies(text) {
+    const parsed = parseValidatedJson(text, validateAnomalies);
+    return parsed.ok ? parsed.value : null;
+}

package/node_modules/@aptkit/agent-anomaly-monitoring/fixtures/promoted/sp-revenue-monitoring-fixture-promoted-2026-06-18-18-37-26.json

@@ -0,0 +1,229 @@
+{
+  "id": "sp-revenue-monitoring-fixture-promoted",
+  "description": "Promoted deterministic monitoring fixture from fixture replay artifact. Source fixture: sp-revenue-monitoring. Replay created at: 2026-06-18T18:37:26.958Z.",
+  "workspace": {
+    "projectId": "olist",
+    "projectName": "Olist Brazilian ecommerce fixture",
+    "events": [
+      {
+        "name": "purchase",
+        "properties": [
+          "state",
+          "category",
+          "total_price"
+        ],
+        "eventCount": 50000
+      },
+      {
+        "name": "session_start",
+        "properties": [
+          "utm_source"
+        ],
+        "eventCount": 80000
+      },
+      {
+        "name": "checkout",
+        "properties": [
+          "state"
+        ],
+        "eventCount": 35000
+      },
+      {
+        "name": "view_item",
+        "properties": [
+          "category"
+        ],
+        "eventCount": 120000
+      }
+    ],
+    "customerProperties": [
+      "state",
+      "city"
+    ],
+    "catalogs": [],
+    "totalCustomers": 125000,
+    "totalEvents": 285000,
+    "oldestTimestamp": 1764547200000,
+    "dataHorizon": {
+      "from": "2025-12-01",
+      "to": "2026-06-01",
+      "durationDays": 182
+    }
+  },
+  "tools": [
+    {
+      "name": "get_metric_timeseries",
+      "description": "Return metric timeseries for an optional dimension.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "metric": {
+            "type": "string"
+          },
+          "dimension": {
+            "type": "string"
+          },
+          "time_range": {
+            "type": "object"
+          },
+          "granularity": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "metric",
+          "time_range"
+        ]
+      },
+      "result": {
+        "periodComparison": {
+          "metric": "revenue",
+          "dimension": "state",
+          "segment": "SP",
+          "recentWindow": {
+            "from": "2026-05-04",
+            "to": "2026-06-01"
+          },
+          "baselineWindow": {
+            "from": "2026-02-09",
+            "to": "2026-05-04"
+          },
+          "recentValue": 28550000,
+          "baselineAverage": 40800000,
+          "pctChange": -0.300245,
+          "relatedSegments": [
+            {
+              "name": "RJ",
+              "pctChange": -0.02
+            },
+            {
+              "name": "MG",
+              "pctChange": 0.01
+            }
+          ]
+        },
+        "points": [
+          {
+            "ts": "2026-05-04",
+            "segment": "SP",
+            "value": 7400000
+          },
+          {
+            "ts": "2026-05-11",
+            "segment": "SP",
+            "value": 7200000
+          },
+          {
+            "ts": "2026-05-18",
+            "segment": "SP",
+            "value": 7050000
+          },
+          {
+            "ts": "2026-05-25",
+            "segment": "SP",
+            "value": 6900000
+          },
+          {
+            "ts": "2026-05-04",
+            "segment": "RJ",
+            "value": 4300000
+          },
+          {
+            "ts": "2026-05-11",
+            "segment": "RJ",
+            "value": 4350000
+          }
+        ],
+        "totalCount": 4200
+      }
+    },
+    {
+      "name": "get_anomaly_context",
+      "description": "Return context for a selected anomaly window and baseline.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "metric": {
+            "type": "string"
+          },
+          "dimension": {
+            "type": "string"
+          },
+          "segment": {
+            "type": "string"
+          },
+          "anomaly_window": {
+            "type": "object"
+          },
+          "baseline_window": {
+            "type": "object"
+          }
+        },
+        "required": [
+          "metric",
+          "dimension",
+          "segment"
+        ]
+      },
+      "result": {
+        "anomaly_summary": {
+          "metric": "revenue",
+          "segment": "SP",
+          "anomaly_value": 28550000,
+          "baseline_avg": 40800000,
+          "pct_change": -0.300245
+        },
+        "related_segments": [
+          {
+            "name": "RJ",
+            "pct_change": -0.02
+          },
+          {
+            "name": "MG",
+            "pct_change": 0.01
+          }
+        ]
+      }
+    }
+  ],
+  "modelResponses": [
+    {
+      "content": [
+        {
+          "type": "text",
+          "text": "```json\n[\n  {\n    \"metric\": \"revenue\",\n    \"category\": \"revenue_drop\",\n    \"scope\": [\n      \"state:SP\"\n    ],\n    \"change\": {\n      \"value\": 30,\n      \"direction\": \"down\",\n      \"baseline\": \"recent 4w vs prior 12w\"\n    },\n    \"severity\": \"critical\",\n    \"impact\": \"Sao Paulo revenue is down about 30% while nearby states are stable, putting the largest regional topline segment at risk if the trend continues.\",\n    \"evidence\": [\n      {\n        \"tool\": \"get_anomaly_context\",\n        \"result\": {\n          \"segment\": \"SP\",\n          \"pct_change\": -0.300245,\n          \"anomaly_value\": 28550000,\n          \"baseline_avg\": 40800000\n        }\n      }\n    ]\n  }\n]\n```"
+        }
+      ],
+      "usage": {
+        "inputTokens": 2680,
+        "outputTokens": 365,
+        "estimated": true
+      },
+      "model": "promoted-fixture-replay"
+    }
+  ],
+  "expectations": {
+    "minAnomalyCount": 1,
+    "requiredCategories": [
+      "revenue_drop"
+    ],
+    "requiredMetrics": [
+      "revenue"
+    ],
+    "requiredScopes": [
+      "state:SP"
+    ],
+    "requiredSeverities": [
+      "critical"
+    ]
+  },
+  "promotion": {
+    "sourceArtifact": "artifacts/replays/2026-06-18T18-37-26-958Z-sp-revenue-monitoring-fixture-studio.json",
+    "sourceProvider": {
+      "id": "fixture",
+      "model": "fixture-model"
+    },
+    "promotedAt": "2026-06-18T18:37:26.963Z",
+    "note": "This fixture captures the final monitoring replay answer deterministically; it does not reconstruct the live provider tool loop."
+  }
+}