@rlynjb/aptkit-core 0.1.0 → 0.2.0

package/README.md

@@ -13,7 +13,7 @@ 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
+npm install @aptkit/core@npm:@rlynjb/aptkit-core@0.2.0
 ```
 
 Because the package is public on npmjs, consumers do not need a package registry token.

package/dist/src/index.d.ts

@@ -3,6 +3,7 @@ export * from '@aptkit/tools';
 export * from '@aptkit/context';
 export * from '@aptkit/prompts';
 export * from '@aptkit/evals';
+export * from '@aptkit/provider-synthetic';
 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';

package/dist/src/index.js

@@ -3,6 +3,7 @@ export * from '@aptkit/tools';
 export * from '@aptkit/context';
 export * from '@aptkit/prompts';
 export * from '@aptkit/evals';
+export * from '@aptkit/provider-synthetic';
 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';

package/node_modules/@aptkit/provider-synthetic/dist/src/fixture-data-source.d.ts

@@ -0,0 +1,18 @@
+import type { WorkspaceDescriptor } from '@aptkit/context';
+import type { AnomalyContextArgs, AnomalyContextResult, MetricTimeseriesArgs, MetricTimeseriesResult, ProjectOverview, SyntheticEcommerceDataSource } from './types.js';
+export declare const syntheticEcommerceWorkspace: WorkspaceDescriptor;
+export type FixtureSyntheticEcommerceDataSourceOptions = {
+    scenarioId?: string;
+    workspace?: WorkspaceDescriptor;
+};
+/** Deterministic synthetic ecommerce data source for Studio, tests, and repeatable demos. */
+export declare class FixtureSyntheticEcommerceDataSource implements SyntheticEcommerceDataSource {
+    readonly mode: "fixture";
+    readonly scenarioId: string;
+    readonly workspace: WorkspaceDescriptor;
+    constructor(options?: FixtureSyntheticEcommerceDataSourceOptions);
+    getProjectOverview(): ProjectOverview;
+    getMetricTimeseries(args?: MetricTimeseriesArgs): MetricTimeseriesResult;
+    getAnomalyContext(args?: AnomalyContextArgs): AnomalyContextResult;
+    private providerMetadata;
+}

package/node_modules/@aptkit/provider-synthetic/dist/src/fixture-data-source.js

@@ -0,0 +1,120 @@
+const DEFAULT_RECENT_WINDOW = { from: '2026-05-04', to: '2026-06-01' };
+const DEFAULT_BASELINE_WINDOW = { from: '2026-02-09', to: '2026-05-04' };
+export const syntheticEcommerceWorkspace = {
+    projectId: 'synthetic-ecommerce',
+    projectName: 'Synthetic ecommerce analytics workspace',
+    events: [
+        { name: 'purchase', properties: ['state', 'category', 'payment_type', 'total_price'], eventCount: 50000 },
+        { name: 'session_start', properties: ['utm_source', 'device'], eventCount: 80000 },
+        { name: 'checkout', properties: ['state', 'payment_type'], eventCount: 35000 },
+        { name: 'view_item', properties: ['category'], eventCount: 120000 },
+    ],
+    customerProperties: ['state', 'city', 'loyalty_tier'],
+    catalogs: [{ id: 'products', name: 'Products' }],
+    totalCustomers: 125000,
+    totalEvents: 285000,
+    oldestTimestamp: Date.UTC(2025, 11, 1),
+    dataHorizon: { from: '2025-12-01', to: '2026-06-01', durationDays: 182 },
+};
+/** Deterministic synthetic ecommerce data source for Studio, tests, and repeatable demos. */
+export class FixtureSyntheticEcommerceDataSource {
+    mode = 'fixture';
+    scenarioId;
+    workspace;
+    constructor(options = {}) {
+        this.scenarioId = options.scenarioId ?? 'sp-revenue-drop';
+        this.workspace = options.workspace ?? syntheticEcommerceWorkspace;
+    }
+    getProjectOverview() {
+        return {
+            provider: this.providerMetadata(),
+            workspace: this.workspace,
+            highlights: [
+                'SP revenue is down 30.0245% over the recent four-week window.',
+                'RJ and MG remain approximately flat, making the movement region-specific.',
+                'The fixture is deterministic and safe for replay promotion.',
+            ],
+        };
+    }
+    getMetricTimeseries(args = {}) {
+        const metric = args.metric ?? 'revenue';
+        const dimension = args.dimension ?? 'state';
+        const segment = args.segment ?? 'SP';
+        const recentWindow = requiredRange(args.time_range, DEFAULT_RECENT_WINDOW);
+        return {
+            provider: this.providerMetadata(),
+            periodComparison: {
+                metric,
+                dimension,
+                segment,
+                recentWindow,
+                baselineWindow: DEFAULT_BASELINE_WINDOW,
+                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 },
+                { ts: '2026-05-04', segment: 'MG', value: 3900000 },
+                { ts: '2026-05-11', segment: 'MG', value: 3940000 },
+            ],
+            totalCount: 4200,
+        };
+    }
+    getAnomalyContext(args = {}) {
+        const metric = args.metric ?? 'revenue';
+        const segment = args.segment ?? 'SP';
+        return {
+            provider: this.providerMetadata(),
+            anomaly_summary: {
+                metric,
+                segment,
+                anomaly_value: 28550000,
+                baseline_avg: 40800000,
+                pct_change: -0.300245,
+            },
+            related_segments: [
+                { name: 'RJ', pct_change: -0.02 },
+                { name: 'MG', pct_change: 0.01 },
+            ],
+            drivers: [
+                {
+                    name: 'electronics',
+                    contribution: -0.62,
+                    detail: 'Electronics orders in SP account for most of the recent revenue loss.',
+                },
+                {
+                    name: 'paid_search',
+                    contribution: -0.21,
+                    detail: 'Paid search sessions declined during the same window.',
+                },
+            ],
+            sample_orders: [
+                { order_id: 'syn-sp-101', purchase_ts: '2026-05-10', status: 'delivered', price_brl: 42000 },
+                { order_id: 'syn-sp-102', purchase_ts: '2026-05-23', status: 'delivered', price_brl: 31000 },
+            ],
+        };
+    }
+    providerMetadata() {
+        return {
+            id: 'synthetic-ecommerce',
+            mode: this.mode,
+            scenarioId: this.scenarioId,
+        };
+    }
+}
+function requiredRange(input, fallback) {
+    return {
+        from: input?.from ?? fallback.from,
+        to: input?.to ?? fallback.to,
+    };
+}

package/node_modules/@aptkit/provider-synthetic/dist/src/index.d.ts

@@ -0,0 +1,5 @@
+export * from './fixture-data-source.js';
+export * from './openai-synthetic-data-source.js';
+export * from './tool-definitions.js';
+export * from './tool-registry.js';
+export * from './types.js';

package/node_modules/@aptkit/provider-synthetic/dist/src/index.js

@@ -0,0 +1,5 @@
+export * from './fixture-data-source.js';
+export * from './openai-synthetic-data-source.js';
+export * from './tool-definitions.js';
+export * from './tool-registry.js';
+export * from './types.js';

package/node_modules/@aptkit/provider-synthetic/dist/src/openai-synthetic-data-source.d.ts

@@ -0,0 +1,22 @@
+import { type ModelProvider } from '@aptkit/runtime';
+import type { AnomalyContextArgs, AnomalyContextResult, MetricTimeseriesArgs, MetricTimeseriesResult, ProjectOverview, SyntheticEcommerceDataSource } from './types.js';
+import type { WorkspaceDescriptor } from '@aptkit/context';
+export type OpenAISyntheticEcommerceDataSourceOptions = {
+    model: ModelProvider;
+    scenarioId?: string;
+    workspace?: WorkspaceDescriptor;
+    systemPrompt?: string;
+};
+/** Model-backed synthetic data source. Use with OpenAIModelProvider or any ModelProvider adapter. */
+export declare class OpenAISyntheticEcommerceDataSource implements SyntheticEcommerceDataSource {
+    readonly mode: "openai";
+    readonly scenarioId: string;
+    readonly workspace: WorkspaceDescriptor;
+    private readonly model;
+    private readonly systemPrompt;
+    constructor(options: OpenAISyntheticEcommerceDataSourceOptions);
+    getProjectOverview(): Promise<ProjectOverview>;
+    getMetricTimeseries(args?: MetricTimeseriesArgs): Promise<MetricTimeseriesResult>;
+    getAnomalyContext(args?: AnomalyContextArgs): Promise<AnomalyContextResult>;
+    private completeJson;
+}

package/node_modules/@aptkit/provider-synthetic/dist/src/openai-synthetic-data-source.js

@@ -0,0 +1,181 @@
+import { parseAgentJson } from '@aptkit/runtime';
+import { syntheticEcommerceWorkspace } from './fixture-data-source.js';
+/** Model-backed synthetic data source. Use with OpenAIModelProvider or any ModelProvider adapter. */
+export class OpenAISyntheticEcommerceDataSource {
+    mode = 'openai';
+    scenarioId;
+    workspace;
+    model;
+    systemPrompt;
+    constructor(options) {
+        this.model = options.model;
+        this.scenarioId = options.scenarioId ?? 'sp-revenue-drop';
+        this.workspace = options.workspace ?? syntheticEcommerceWorkspace;
+        this.systemPrompt = options.systemPrompt ?? [
+            'You generate synthetic ecommerce analytics tool results for AptKit.',
+            'Return only JSON. Do not include prose or markdown fences.',
+            'Keep outputs internally consistent for the requested scenario and workspace.',
+            'Always include provider metadata: {"id":"synthetic-ecommerce","mode":"openai","scenarioId": string}.',
+        ].join('\n');
+    }
+    async getProjectOverview() {
+        const value = await this.completeJson('get_project_overview', {});
+        return assertProjectOverview(value, this.scenarioId);
+    }
+    async getMetricTimeseries(args = {}) {
+        const value = await this.completeJson('get_metric_timeseries', args);
+        return assertMetricTimeseries(value, this.scenarioId);
+    }
+    async getAnomalyContext(args = {}) {
+        const value = await this.completeJson('get_anomaly_context', args);
+        return assertAnomalyContext(value, this.scenarioId);
+    }
+    async completeJson(toolName, args) {
+        const response = await this.model.complete({
+            system: this.systemPrompt,
+            messages: [
+                {
+                    role: 'user',
+                    content: JSON.stringify({
+                        toolName,
+                        scenarioId: this.scenarioId,
+                        workspace: this.workspace,
+                        args,
+                    }),
+                },
+            ],
+            maxTokens: 1400,
+            temperature: 0.2,
+        });
+        const text = response.content
+            .filter((block) => block.type === 'text')
+            .map((block) => block.text)
+            .join('\n');
+        return parseAgentJson(text);
+    }
+}
+function assertProjectOverview(value, scenarioId) {
+    const object = assertObject(value, 'project overview');
+    if (!isObject(object.workspace))
+        throw new Error('project overview workspace is missing');
+    return {
+        provider: providerMetadata(object.provider, scenarioId, 'openai'),
+        workspace: object.workspace,
+        highlights: stringArray(object.highlights, 'highlights'),
+    };
+}
+function assertMetricTimeseries(value, scenarioId) {
+    const object = assertObject(value, 'metric timeseries');
+    const comparison = assertObject(object.periodComparison, 'periodComparison');
+    return {
+        provider: providerMetadata(object.provider, scenarioId, 'openai'),
+        periodComparison: {
+            metric: stringValue(comparison.metric, 'periodComparison.metric'),
+            dimension: stringValue(comparison.dimension, 'periodComparison.dimension'),
+            segment: stringValue(comparison.segment, 'periodComparison.segment'),
+            recentWindow: timeRange(comparison.recentWindow, 'periodComparison.recentWindow'),
+            baselineWindow: timeRange(comparison.baselineWindow, 'periodComparison.baselineWindow'),
+            recentValue: numberValue(comparison.recentValue, 'periodComparison.recentValue'),
+            baselineAverage: numberValue(comparison.baselineAverage, 'periodComparison.baselineAverage'),
+            pctChange: numberValue(comparison.pctChange, 'periodComparison.pctChange'),
+            relatedSegments: relatedSegments(comparison.relatedSegments),
+        },
+        points: metricPoints(object.points),
+        totalCount: numberValue(object.totalCount, 'totalCount'),
+    };
+}
+function assertAnomalyContext(value, scenarioId) {
+    const object = assertObject(value, 'anomaly context');
+    const summary = assertObject(object.anomaly_summary, 'anomaly_summary');
+    return {
+        provider: providerMetadata(object.provider, scenarioId, 'openai'),
+        anomaly_summary: {
+            metric: stringValue(summary.metric, 'anomaly_summary.metric'),
+            segment: stringValue(summary.segment, 'anomaly_summary.segment'),
+            anomaly_value: numberValue(summary.anomaly_value, 'anomaly_summary.anomaly_value'),
+            baseline_avg: numberValue(summary.baseline_avg, 'anomaly_summary.baseline_avg'),
+            pct_change: numberValue(summary.pct_change, 'anomaly_summary.pct_change'),
+        },
+        related_segments: relatedSegments(object.related_segments).map((segment) => ({
+            name: segment.name,
+            pct_change: segment.pctChange,
+        })),
+        drivers: arrayValue(object.drivers, 'drivers').map((driver, index) => {
+            const objectDriver = assertObject(driver, `drivers.${index}`);
+            return {
+                name: stringValue(objectDriver.name, `drivers.${index}.name`),
+                contribution: numberValue(objectDriver.contribution, `drivers.${index}.contribution`),
+                detail: stringValue(objectDriver.detail, `drivers.${index}.detail`),
+            };
+        }),
+        sample_orders: arrayValue(object.sample_orders, 'sample_orders').map((order, index) => {
+            const objectOrder = assertObject(order, `sample_orders.${index}`);
+            return {
+                order_id: stringValue(objectOrder.order_id, `sample_orders.${index}.order_id`),
+                purchase_ts: stringValue(objectOrder.purchase_ts, `sample_orders.${index}.purchase_ts`),
+                status: stringValue(objectOrder.status, `sample_orders.${index}.status`),
+                price_brl: numberValue(objectOrder.price_brl, `sample_orders.${index}.price_brl`),
+            };
+        }),
+    };
+}
+function providerMetadata(value, scenarioId, mode) {
+    const provider = isObject(value) ? value : {};
+    return {
+        id: 'synthetic-ecommerce',
+        mode,
+        scenarioId: typeof provider.scenarioId === 'string' ? provider.scenarioId : scenarioId,
+    };
+}
+function relatedSegments(value) {
+    return arrayValue(value, 'relatedSegments').map((segment, index) => {
+        const object = assertObject(segment, `relatedSegments.${index}`);
+        return {
+            name: stringValue(object.name, `relatedSegments.${index}.name`),
+            pctChange: numberValue(object.pctChange ?? object.pct_change, `relatedSegments.${index}.pctChange`),
+        };
+    });
+}
+function metricPoints(value) {
+    return arrayValue(value, 'points').map((point, index) => {
+        const object = assertObject(point, `points.${index}`);
+        return {
+            ts: stringValue(object.ts, `points.${index}.ts`),
+            segment: stringValue(object.segment, `points.${index}.segment`),
+            value: numberValue(object.value, `points.${index}.value`),
+        };
+    });
+}
+function timeRange(value, path) {
+    const object = assertObject(value, path);
+    return {
+        from: stringValue(object.from, `${path}.from`),
+        to: stringValue(object.to, `${path}.to`),
+    };
+}
+function assertObject(value, path) {
+    if (!isObject(value))
+        throw new Error(`${path} must be an object`);
+    return value;
+}
+function isObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function arrayValue(value, path) {
+    if (!Array.isArray(value))
+        throw new Error(`${path} must be an array`);
+    return value;
+}
+function stringArray(value, path) {
+    return arrayValue(value, path).map((item, index) => stringValue(item, `${path}.${index}`));
+}
+function stringValue(value, path) {
+    if (typeof value !== 'string')
+        throw new Error(`${path} must be a string`);
+    return value;
+}
+function numberValue(value, path) {
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        throw new Error(`${path} must be a number`);
+    return value;
+}

package/node_modules/@aptkit/provider-synthetic/dist/src/tool-definitions.d.ts

@@ -0,0 +1,2 @@
+import type { ToolDefinition } from '@aptkit/tools';
+export declare const syntheticEcommerceToolDefinitions: ToolDefinition[];

package/node_modules/@aptkit/provider-synthetic/dist/src/tool-definitions.js

@@ -0,0 +1,59 @@
+export const syntheticEcommerceToolDefinitions = [
+    {
+        name: 'get_project_overview',
+        description: 'Return synthetic ecommerce workspace metadata and data horizon.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+            additionalProperties: false,
+        },
+    },
+    {
+        name: 'get_metric_timeseries',
+        description: 'Return synthetic ecommerce metric timeseries for an optional dimension and segment.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                metric: { type: 'string' },
+                dimension: { type: 'string' },
+                segment: { type: 'string' },
+                time_range: {
+                    type: 'object',
+                    properties: {
+                        from: { type: 'string' },
+                        to: { type: 'string' },
+                    },
+                },
+                granularity: { type: 'string' },
+            },
+            required: ['metric'],
+        },
+    },
+    {
+        name: 'get_anomaly_context',
+        description: 'Return synthetic ecommerce anomaly context, related segments, and sample records.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                metric: { type: 'string' },
+                dimension: { type: 'string' },
+                segment: { type: 'string' },
+                anomaly_window: {
+                    type: 'object',
+                    properties: {
+                        from: { type: 'string' },
+                        to: { type: 'string' },
+                    },
+                },
+                baseline_window: {
+                    type: 'object',
+                    properties: {
+                        from: { type: 'string' },
+                        to: { type: 'string' },
+                    },
+                },
+            },
+            required: ['metric', 'dimension', 'segment'],
+        },
+    },
+];

package/node_modules/@aptkit/provider-synthetic/dist/src/tool-registry.d.ts

@@ -0,0 +1,15 @@
+import type { ToolCallOptions, ToolCallResult, ToolDefinition, ToolRegistry } from '@aptkit/tools';
+import type { SyntheticEcommerceDataSource } from './types.js';
+export type SyntheticEcommerceToolRegistryOptions = {
+    dataSource: SyntheticEcommerceDataSource;
+    tools?: readonly ToolDefinition[];
+};
+/** ToolRegistry adapter that exposes synthetic ecommerce data through normal agent tools. */
+export declare class SyntheticEcommerceToolRegistry implements ToolRegistry {
+    private readonly dataSource;
+    private readonly tools;
+    constructor(options: SyntheticEcommerceToolRegistryOptions);
+    listTools(): ToolDefinition[];
+    callTool(name: string, args: Record<string, unknown>, options?: ToolCallOptions): Promise<ToolCallResult>;
+    private dispatch;
+}

package/node_modules/@aptkit/provider-synthetic/dist/src/tool-registry.js

@@ -0,0 +1,28 @@
+import { syntheticEcommerceToolDefinitions } from './tool-definitions.js';
+/** ToolRegistry adapter that exposes synthetic ecommerce data through normal agent tools. */
+export class SyntheticEcommerceToolRegistry {
+    dataSource;
+    tools;
+    constructor(options) {
+        this.dataSource = options.dataSource;
+        this.tools = options.tools ?? syntheticEcommerceToolDefinitions;
+    }
+    listTools() {
+        return [...this.tools];
+    }
+    async callTool(name, args, options) {
+        options?.signal?.throwIfAborted();
+        const start = performance.now();
+        const result = await this.dispatch(name, args);
+        return { result, durationMs: Math.round(performance.now() - start) };
+    }
+    dispatch(name, args) {
+        if (name === 'get_project_overview')
+            return this.dataSource.getProjectOverview();
+        if (name === 'get_metric_timeseries')
+            return this.dataSource.getMetricTimeseries(args);
+        if (name === 'get_anomaly_context')
+            return this.dataSource.getAnomalyContext(args);
+        throw new Error(`synthetic ecommerce tool not found: ${name}`);
+    }
+}

package/node_modules/@aptkit/provider-synthetic/dist/src/types.d.ts

@@ -0,0 +1,94 @@
+import type { WorkspaceDescriptor } from '@aptkit/context';
+export type SyntheticProviderMode = 'fixture' | 'openai';
+export type TimeRange = {
+    from?: string;
+    to?: string;
+};
+export type ProjectOverview = {
+    provider: {
+        id: 'synthetic-ecommerce';
+        mode: SyntheticProviderMode;
+        scenarioId: string;
+    };
+    workspace: WorkspaceDescriptor;
+    highlights: string[];
+};
+export type MetricTimeseriesArgs = {
+    metric?: string;
+    dimension?: string;
+    segment?: string;
+    time_range?: TimeRange;
+    granularity?: 'day' | 'week' | 'month' | string;
+};
+export type MetricPoint = {
+    ts: string;
+    segment: string;
+    value: number;
+};
+export type MetricTimeseriesResult = {
+    provider: {
+        id: 'synthetic-ecommerce';
+        mode: SyntheticProviderMode;
+        scenarioId: string;
+    };
+    periodComparison: {
+        metric: string;
+        dimension: string;
+        segment: string;
+        recentWindow: Required<TimeRange>;
+        baselineWindow: Required<TimeRange>;
+        recentValue: number;
+        baselineAverage: number;
+        pctChange: number;
+        relatedSegments: {
+            name: string;
+            pctChange: number;
+        }[];
+    };
+    points: MetricPoint[];
+    totalCount: number;
+};
+export type AnomalyContextArgs = {
+    metric?: string;
+    dimension?: string;
+    segment?: string;
+    anomaly_window?: TimeRange;
+    baseline_window?: TimeRange;
+};
+export type AnomalyContextResult = {
+    provider: {
+        id: 'synthetic-ecommerce';
+        mode: SyntheticProviderMode;
+        scenarioId: string;
+    };
+    anomaly_summary: {
+        metric: string;
+        segment: string;
+        anomaly_value: number;
+        baseline_avg: number;
+        pct_change: number;
+    };
+    related_segments: {
+        name: string;
+        pct_change: number;
+    }[];
+    drivers: {
+        name: string;
+        contribution: number;
+        detail: string;
+    }[];
+    sample_orders: {
+        order_id: string;
+        purchase_ts: string;
+        status: string;
+        price_brl: number;
+    }[];
+};
+export type SyntheticEcommerceDataSource = {
+    readonly mode: SyntheticProviderMode;
+    readonly scenarioId: string;
+    readonly workspace: WorkspaceDescriptor;
+    getProjectOverview(): Promise<ProjectOverview> | ProjectOverview;
+    getMetricTimeseries(args?: MetricTimeseriesArgs): Promise<MetricTimeseriesResult> | MetricTimeseriesResult;
+    getAnomalyContext(args?: AnomalyContextArgs): Promise<AnomalyContextResult> | AnomalyContextResult;
+};

package/node_modules/@aptkit/provider-synthetic/dist/src/types.js

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

package/node_modules/@aptkit/provider-synthetic/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@aptkit/provider-synthetic",
+  "version": "0.0.0",
+  "type": "module",
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "files": [
+    "dist/src"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "npm run build && node --test dist/test/*.test.js"
+  },
+  "dependencies": {
+    "@aptkit/context": "0.0.0",
+    "@aptkit/runtime": "0.0.0",
+    "@aptkit/tools": "0.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0"
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rlynjb/aptkit-core",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "type": "module",
   "description": "Standalone AptKit core bundle for extracted agent capabilities.",
   "main": "./dist/src/index.js",
@@ -36,6 +36,7 @@
     "@aptkit/context": "0.0.0",
     "@aptkit/evals": "0.0.0",
     "@aptkit/prompts": "0.0.0",
+    "@aptkit/provider-synthetic": "0.0.0",
     "@aptkit/runtime": "0.0.0",
     "@aptkit/tools": "0.0.0"
   },
@@ -47,6 +48,7 @@
     "@aptkit/context",
     "@aptkit/evals",
     "@aptkit/prompts",
+    "@aptkit/provider-synthetic",
     "@aptkit/runtime",
     "@aptkit/tools"
   ]