react-semaphor 0.1.334 → 0.1.336

package/dist/types/analytics-protocol.d.ts

@@ -97,7 +97,8 @@ export declare const SEMAPHOR_ANALYTICS_INTENT_FIXTURES: {
             readonly connectionId: "conn_sales";
             readonly label: "Orders";
         };
-        metric: string;
+        metrics: string[];
+        primaryMetric: string;
         comparison: {
             kind: "previous_period";
         };
@@ -189,7 +190,8 @@ export declare const SEMAPHOR_ANALYTICS_INTENT_FIXTURES: {
             readonly connectionId: "conn_sales";
             readonly label: "Orders";
         };
-        metric: string;
+        metrics: string[];
+        primaryMetric: string;
         dateField: {
             name: string;
             role: "date";
@@ -201,6 +203,46 @@ export declare const SEMAPHOR_ANALYTICS_INTENT_FIXTURES: {
         };
         limit: number;
     };
+    inboundSupplierConcentration: {
+        version: 1;
+        kind: "metric";
+        id: string;
+        label: string;
+        source: {
+            readonly kind: "semantic";
+            readonly domainId: "domain_sales";
+            readonly datasetName: "orders";
+            readonly connectionId: "conn_sales";
+            readonly label: "Orders";
+        };
+        metrics: string[];
+        primaryMetric: string;
+        dateField: {
+            name: string;
+            role: "date";
+            dataType: "date";
+        };
+        timeWindow: {
+            unit: "month";
+            value: number;
+            anchor: "latest_available";
+        };
+        dimensions: {
+            name: string;
+            role: "dimension";
+            dataType: "number";
+        }[];
+        filters: {
+            field: {
+                name: string;
+                role: "dimension";
+                dataType: "string";
+            };
+            operator: "=";
+            value: string;
+        }[];
+        limit: number;
+    };
     boundedSqlRanking: {
         version: 1;
         kind: "sql";
@@ -229,24 +271,89 @@ export declare const SEMAPHOR_ANALYTICS_INTENT_FIXTURES: {
     };
 };
 
+export declare type SemaphorAgentFilterInput = {
+    id?: string;
+    field: string | SemaphorFieldRef;
+    operator?: SemaphorAgentFilterInputOperator;
+    operation?: SemaphorAgentFilterInputOperator | string;
+    value?: unknown;
+    values?: unknown[];
+};
+
+export declare type SemaphorAgentFilterInputOperator = SemaphorAnalyticsFilterOperator | 'equals' | 'eq' | 'not_equals' | 'neq' | 'like' | 'not_like' | 'not in' | 'not contains' | 'not between' | 'is_null' | 'is_not_null' | 'is null' | 'is not null';
+
 export declare type SemaphorAnalyticsExecutionResult = {
     intentId?: string;
     queryId?: string;
     status: SemaphorAnalyticsExecutionStatus;
+    resultShape?: SemaphorAnalyticsResult['kind'] | 'period_change';
+    intent?: SemaphorAnalyticsIntent;
+    compiledQuery?: SemaphorCompiledQuery;
+    fieldsUsed?: SemaphorFieldRef[];
     result?: SemaphorAnalyticsResult;
     validation: SemaphorAnalyticsValidationResult;
+    coverage?: {
+        answeredObligations: string[];
+        missingObligations: string[];
+        warnings: SemaphorAnalyticsValidationIssue[];
+    };
     missingFields?: string[];
     warnings?: string[];
+    relationshipDiagnostics?: SemaphorRelationshipDiagnostics;
+    metadata?: Record<string, unknown>;
 };
 
 export declare type SemaphorAnalyticsExecutionStatus = 'answered' | 'partial' | 'failed';
 
 export declare type SemaphorAnalyticsFieldRole = 'metric' | 'dateField' | 'dimension' | 'input' | 'source' | 'sql';
 
+export declare type SemaphorAnalyticsFilter = {
+    id?: string;
+    field: SemaphorFieldRef;
+    operator?: SemaphorAnalyticsFilterOperator;
+    value?: unknown;
+    values?: unknown[];
+};
+
+export declare type SemaphorAnalyticsFilterOperator = SemaphorInputOperator | 'not_contains' | 'is_null' | 'is_not_null';
+
 export declare type SemaphorAnalyticsIntent = SemaphorMetricIntent | SemaphorRecordsIntent | SemaphorInputOptionsIntent | SemaphorSqlIntent;
 
 export declare type SemaphorAnalyticsIntentFixtureName = keyof typeof SEMAPHOR_ANALYTICS_INTENT_FIXTURES;
 
+export declare type SemaphorAnalyticsObligation = {
+    id: string;
+    type: SemaphorAnalyticsObligationType;
+    subject: string;
+    prompt: string;
+    metricCandidates?: string[];
+    entityCandidates?: string[];
+    dateFieldCandidates?: string[];
+    dimensionCandidates?: string[];
+    displayFieldCandidates?: string[];
+    requiredFieldCandidates?: string[];
+    limit?: number;
+    timeWindowDays?: number;
+    timeWindowMonths?: number;
+    comparison?: 'same_period_last_year' | 'previous_period';
+    required?: boolean;
+};
+
+export declare type SemaphorAnalyticsObligationType = 'record_list' | 'count' | 'trend' | 'comparison' | 'driver_analysis' | 'metric_summary' | 'analysis_table' | 'lookup' | 'unknown';
+
+export declare type SemaphorAnalyticsRecoveryPlan = {
+    version: SemaphorProtocolVersion;
+    kind: 'analytics_recovery_plan';
+    operationIntent: SemaphorOperationIntent;
+    plannedToolCalls: SemaphorRecoveryToolCall[];
+    diagnostics: Array<{
+        code: string;
+        message: string;
+        obligationId?: string;
+        recommendedNextStep?: string;
+    }>;
+};
+
 export declare type SemaphorAnalyticsRepairHint = {
     code: SemaphorAnalyticsValidationCode | string;
     message?: string;
@@ -363,7 +470,7 @@ export declare type SemaphorInputBinding = {
     field?: SemaphorFieldRef;
 };
 
-export declare type SemaphorInputOperator = '=' | '!=' | 'in' | 'not_in' | 'contains' | 'between' | '>' | '>=' | '<' | '<=';
+export declare type SemaphorInputOperator = '=' | '!=' | 'in' | 'not_in' | 'contains' | 'between' | 'not_between' | '>' | '>=' | '<' | '<=';
 
 export declare type SemaphorInputOptionsIntent = {
     kind: 'inputOptions';
@@ -409,21 +516,32 @@ export declare type SemaphorInputSpec = {
     scope?: SemaphorInputScope;
 };
 
+export declare type SemaphorMetricAnalysis = {
+    kind: 'period_change';
+    orderBy?: 'absolute_change' | 'positive_change' | 'negative_change';
+    direction?: 'increase' | 'decrease' | 'both';
+    timeWindow?: SemaphorTimeWindow;
+};
+
 export declare type SemaphorMetricIntent = {
     kind: 'metric';
     version?: SemaphorProtocolVersion;
     id?: string;
     source: SemaphorSourceRef;
-    metric: string;
-    metrics?: string[];
+    metrics: string[];
+    primaryMetric?: string;
+    metricRefs?: SemaphorFieldRef[];
     label?: string;
     dateField?: SemaphorFieldRef;
     timeGrain?: SemaphorTimeGrain;
+    timeWindow?: SemaphorTimeWindow;
     dimensions?: SemaphorFieldRef[];
+    filters?: SemaphorAnalyticsFilter[];
     comparison?: {
         kind: 'previous_period' | 'previous_year' | 'target';
         targetValue?: number;
     };
+    analysis?: SemaphorMetricAnalysis;
     inputs?: SemaphorInputBinding[];
     limit?: number;
 };
@@ -439,6 +557,27 @@ export declare type SemaphorMetricResult = SemaphorAnalyticsResultBase & {
     };
 };
 
+export declare type SemaphorOperationIntent = {
+    version: SemaphorProtocolVersion;
+    kind: 'answer_obligations';
+    obligations: SemaphorAnalyticsObligation[];
+    source?: SemaphorSourceRef;
+    context?: Record<string, unknown>;
+} | {
+    version: SemaphorProtocolVersion;
+    kind: 'dashboard_change';
+    instruction: string;
+    targetDashboardId?: string;
+    analyticsIntent?: SemaphorAnalyticsIntent;
+    context?: Record<string, unknown>;
+} | {
+    version: SemaphorProtocolVersion;
+    kind: 'data_app_change';
+    instruction: string;
+    analyticsIntent?: SemaphorAnalyticsIntent;
+    context?: Record<string, unknown>;
+};
+
 export declare type SemaphorProtocolIssue = {
     code: string;
     message: string;
@@ -477,6 +616,35 @@ export declare type SemaphorRecordsResult = SemaphorAnalyticsResultBase & {
     records: Array<Record<string, unknown>>;
 };
 
+export declare type SemaphorRecoveryToolCall = {
+    name: 'semaphor_get_dataset_schema' | 'semaphor_query_spec' | 'semaphor_query_sql' | string;
+    arguments: Record<string, unknown>;
+    purpose: string;
+    obligationId?: string;
+    recoveryKind?: 'schema_discovery' | 'query_spec' | 'sql' | 'unsupported';
+};
+
+export declare type SemaphorRelationshipDiagnostics = {
+    status: SemaphorRelationshipDiagnosticStatus;
+    requiredSources?: SemaphorSourceRef[];
+    relationshipsUsed?: string[];
+    missingSources?: string[];
+    warnings?: string[];
+    message?: string;
+    recommendedNextStep?: string;
+    joinPlanSummary?: {
+        baseSource?: SemaphorSourceRef;
+        joinedSources?: SemaphorSourceRef[];
+        joinCount?: number;
+    };
+    fanoutRisk?: {
+        status: 'none' | 'warning' | 'error' | 'unknown';
+        message?: string;
+    };
+};
+
+export declare type SemaphorRelationshipDiagnosticStatus = 'not_required' | 'resolved' | 'missing' | 'ambiguous' | 'fanout_risk' | 'unknown';
+
 export declare type SemaphorSourceCoordinateInput = {
     databaseName?: string;
     schemaName?: string;
@@ -544,6 +712,12 @@ export declare type SemaphorSqlResult = SemaphorAnalyticsResultBase & {
 
 export declare type SemaphorTimeGrain = 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'year';
 
+export declare type SemaphorTimeWindow = {
+    unit: 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'year';
+    value: number;
+    anchor?: 'now' | 'latest_available';
+};
+
 export declare type SemaphorValidationResult = {
     ok: boolean;
     errors: SemaphorProtocolIssue[];
@@ -566,6 +740,10 @@ export declare type SemaphorViewPresentation = {
 
 export declare function validateSemaphorAnalyticsIntent(intent: SemaphorAnalyticsIntent): SemaphorAnalyticsValidationResult;
 
+export declare function validateSemaphorAnalyticsRecoveryPlan(plan: SemaphorAnalyticsRecoveryPlan): SemaphorAnalyticsValidationResult;
+
 export declare function validateSemaphorDashboardIntent(intent: SemaphorDashboardIntent): SemaphorValidationResult;
 
+export declare function validateSemaphorOperationIntent(intent: SemaphorOperationIntent): SemaphorAnalyticsValidationResult;
+
 export { }

package/dist/types/briefings.d.ts

@@ -21,6 +21,7 @@ export declare const BRIEFING_TEXT_LIMITS: {
     readonly contentTitle: 500;
     readonly contentSummary: 20000;
     readonly contentText: 5000;
+    readonly contentSql: 50000;
     readonly contentItem: 2000;
     readonly contentCell: 500;
     readonly attachmentTitle: 500;
@@ -144,6 +145,12 @@ export declare type BriefingContentBlock = {
     title?: string;
     tiles: BriefingKpiTile[];
     evidenceIds?: string[];
+} | {
+    type: 'progress';
+    label: string;
+    value: number;
+    detail?: string;
+    evidenceIds?: string[];
 } | BriefingContentTableBlock | {
     type: 'actions';
     title?: string;
@@ -154,6 +161,11 @@ export declare type BriefingContentBlock = {
     title?: string;
     items: string[];
     evidenceIds?: string[];
+} | {
+    type: 'sql';
+    title?: string;
+    sql: string;
+    evidenceIds?: string[];
 } | {
     type: 'evidence_appendix';
     title?: string;

package/dist/types/dashboard-authoring.d.ts

@@ -550,13 +550,15 @@ export declare type DashboardCardQueryFieldRef = {
 };
 
 export declare type DashboardCardQueryIntent = {
-    metric?: string;
     metrics?: string[];
+    primaryMetric?: string;
+    metricRefs?: DashboardCardQueryFieldRef[];
     dateField?: string;
     dateFieldRef?: DashboardCardQueryFieldRef;
     timeGrain?: 'day' | 'week' | 'month' | 'quarter' | 'year';
     dimensions?: string[];
     dimensionRefs?: DashboardCardQueryFieldRef[];
+    filters?: SemaphorAnalyticsFilter[];
     limit?: number;
 };
 
@@ -1827,6 +1829,16 @@ declare type SelectedEntities = SelectedEntity[];
 
 declare type SelectedEntity = DatabaseEntityReference | DataModelEntityReference | DatasetEntityReference | FileEntityReference;
 
+declare type SemaphorAnalyticsFilter = {
+    id?: string;
+    field: SemaphorFieldRef;
+    operator?: SemaphorAnalyticsFilterOperator;
+    value?: unknown;
+    values?: unknown[];
+};
+
+declare type SemaphorAnalyticsFilterOperator = SemaphorInputOperator | 'not_contains' | 'is_null' | 'is_not_null';
+
 declare type SemaphorAnalyticsIntent = SemaphorMetricIntent | SemaphorRecordsIntent | SemaphorInputOptionsIntent | SemaphorSqlIntent;
 
 declare type SemaphorDashboardIntent = {
@@ -1869,7 +1881,7 @@ declare type SemaphorInputBinding = {
     field?: SemaphorFieldRef;
 };
 
-declare type SemaphorInputOperator = '=' | '!=' | 'in' | 'not_in' | 'contains' | 'between' | '>' | '>=' | '<' | '<=';
+declare type SemaphorInputOperator = '=' | '!=' | 'in' | 'not_in' | 'contains' | 'between' | 'not_between' | '>' | '>=' | '<' | '<=';
 
 declare type SemaphorInputOptionsIntent = {
     kind: 'inputOptions';
@@ -1906,21 +1918,32 @@ declare type SemaphorInputSpec = {
     scope?: SemaphorInputScope;
 };
 
+declare type SemaphorMetricAnalysis = {
+    kind: 'period_change';
+    orderBy?: 'absolute_change' | 'positive_change' | 'negative_change';
+    direction?: 'increase' | 'decrease' | 'both';
+    timeWindow?: SemaphorTimeWindow;
+};
+
 declare type SemaphorMetricIntent = {
     kind: 'metric';
     version?: SemaphorProtocolVersion;
     id?: string;
     source: SemaphorSourceRef;
-    metric: string;
-    metrics?: string[];
+    metrics: string[];
+    primaryMetric?: string;
+    metricRefs?: SemaphorFieldRef[];
     label?: string;
     dateField?: SemaphorFieldRef;
     timeGrain?: SemaphorTimeGrain;
+    timeWindow?: SemaphorTimeWindow;
     dimensions?: SemaphorFieldRef[];
+    filters?: SemaphorAnalyticsFilter[];
     comparison?: {
         kind: 'previous_period' | 'previous_year' | 'target';
         targetValue?: number;
     };
+    analysis?: SemaphorMetricAnalysis;
     inputs?: SemaphorInputBinding[];
     limit?: number;
 };
@@ -1988,6 +2011,12 @@ declare type SemaphorSqlIntent = {
 
 declare type SemaphorTimeGrain = 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'year';
 
+declare type SemaphorTimeWindow = {
+    unit: 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'year';
+    value: number;
+    anchor?: 'now' | 'latest_available';
+};
+
 declare type SemaphorViewPresentation = {
     kind: 'kpi';
     format?: 'number' | 'currency' | 'percent' | 'duration';

package/dist/types/data-app-builder.d.ts

@@ -480,6 +480,16 @@ export declare type GeneratedRevision = {
 
 export declare type ReasoningEffort = 'low' | 'medium' | 'high';
 
+declare type SemaphorAnalyticsFilter = {
+    id?: string;
+    field: SemaphorFieldRef;
+    operator?: SemaphorAnalyticsFilterOperator;
+    value?: unknown;
+    values?: unknown[];
+};
+
+declare type SemaphorAnalyticsFilterOperator = SemaphorInputOperator | 'not_contains' | 'is_null' | 'is_not_null';
+
 declare type SemaphorAnalyticsIntent = SemaphorMetricIntent | SemaphorRecordsIntent | SemaphorInputOptionsIntent | SemaphorSqlIntent;
 
 declare type SemaphorDialect = 'semantic' | 'postgres' | 'mysql' | 'mssql' | 'snowflake' | 'clickhouse' | 'bigquery' | 'redshift' | 'duckdb' | 'sqlite' | 'unknown';
@@ -497,7 +507,7 @@ declare type SemaphorInputBinding = {
     field?: SemaphorFieldRef;
 };
 
-declare type SemaphorInputOperator = '=' | '!=' | 'in' | 'not_in' | 'contains' | 'between' | '>' | '>=' | '<' | '<=';
+declare type SemaphorInputOperator = '=' | '!=' | 'in' | 'not_in' | 'contains' | 'between' | 'not_between' | '>' | '>=' | '<' | '<=';
 
 declare type SemaphorInputOptionsIntent = {
     kind: 'inputOptions';
@@ -510,21 +520,32 @@ declare type SemaphorInputOptionsIntent = {
     limit?: number;
 };
 
+declare type SemaphorMetricAnalysis = {
+    kind: 'period_change';
+    orderBy?: 'absolute_change' | 'positive_change' | 'negative_change';
+    direction?: 'increase' | 'decrease' | 'both';
+    timeWindow?: SemaphorTimeWindow;
+};
+
 declare type SemaphorMetricIntent = {
     kind: 'metric';
     version?: SemaphorProtocolVersion;
     id?: string;
     source: SemaphorSourceRef;
-    metric: string;
-    metrics?: string[];
+    metrics: string[];
+    primaryMetric?: string;
+    metricRefs?: SemaphorFieldRef[];
     label?: string;
     dateField?: SemaphorFieldRef;
     timeGrain?: SemaphorTimeGrain;
+    timeWindow?: SemaphorTimeWindow;
     dimensions?: SemaphorFieldRef[];
+    filters?: SemaphorAnalyticsFilter[];
     comparison?: {
         kind: 'previous_period' | 'previous_year' | 'target';
         targetValue?: number;
     };
+    analysis?: SemaphorMetricAnalysis;
     inputs?: SemaphorInputBinding[];
     limit?: number;
 };
@@ -592,6 +613,12 @@ declare type SemaphorSqlIntent = {
 
 declare type SemaphorTimeGrain = 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'year';
 
+declare type SemaphorTimeWindow = {
+    unit: 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'year';
+    value: number;
+    anchor?: 'now' | 'latest_available';
+};
+
 export declare type WorkspaceContext = {
     projectRoot?: string;
     framework?: string;

package/dist/types/data-app-sdk.d.ts

@@ -16,6 +16,16 @@ export declare function normalizeSemaphorInputOptions(options?: Array<{
 
 export declare function readWindowRuntime(): SemaphorDataAppWindowRuntime | undefined;
 
+declare type SemaphorAnalyticsFilter = {
+    id?: string;
+    field: SemaphorFieldRef;
+    operator?: SemaphorAnalyticsFilterOperator;
+    value?: unknown;
+    values?: unknown[];
+};
+
+declare type SemaphorAnalyticsFilterOperator = SemaphorInputOperator | 'not_contains' | 'is_null' | 'is_not_null';
+
 declare type SemaphorAnalyticsIntent = SemaphorMetricIntent | SemaphorRecordsIntent | SemaphorInputOptionsIntent | SemaphorSqlIntent;
 
 export declare const SemaphorDataAppContext: Context<SemaphorDataAppRuntime>;
@@ -139,8 +149,8 @@ export declare type SemaphorDataAppMetricResult = SemaphorDataAppQueryState & Se
 export declare type SemaphorDataAppMetricSpec = SemaphorDataAppSourceSpec & {
     id?: string;
     label?: string;
-    metric: string;
-    metrics?: string[];
+    metrics: SemaphorDataAppNonEmptyArray<string>;
+    primaryMetric?: string;
     dateField?: SemaphorDataAppFieldSpec;
     timeGrain?: SemaphorTimeGrain;
     dimensions?: SemaphorDataAppFieldSpec[];
@@ -261,7 +271,7 @@ declare type SemaphorInputBinding = {
     field?: SemaphorFieldRef;
 };
 
-declare type SemaphorInputOperator = '=' | '!=' | 'in' | 'not_in' | 'contains' | 'between' | '>' | '>=' | '<' | '<=';
+declare type SemaphorInputOperator = '=' | '!=' | 'in' | 'not_in' | 'contains' | 'between' | 'not_between' | '>' | '>=' | '<' | '<=';
 
 declare type SemaphorInputOptionsIntent = {
     kind: 'inputOptions';
@@ -274,21 +284,32 @@ declare type SemaphorInputOptionsIntent = {
     limit?: number;
 };
 
+declare type SemaphorMetricAnalysis = {
+    kind: 'period_change';
+    orderBy?: 'absolute_change' | 'positive_change' | 'negative_change';
+    direction?: 'increase' | 'decrease' | 'both';
+    timeWindow?: SemaphorTimeWindow;
+};
+
 declare type SemaphorMetricIntent = {
     kind: 'metric';
     version?: SemaphorProtocolVersion;
     id?: string;
     source: SemaphorSourceRef;
-    metric: string;
-    metrics?: string[];
+    metrics: string[];
+    primaryMetric?: string;
+    metricRefs?: SemaphorFieldRef[];
     label?: string;
     dateField?: SemaphorFieldRef;
     timeGrain?: SemaphorTimeGrain;
+    timeWindow?: SemaphorTimeWindow;
     dimensions?: SemaphorFieldRef[];
+    filters?: SemaphorAnalyticsFilter[];
     comparison?: {
         kind: 'previous_period' | 'previous_year' | 'target';
         targetValue?: number;
     };
+    analysis?: SemaphorMetricAnalysis;
     inputs?: SemaphorInputBinding[];
     limit?: number;
 };
@@ -356,6 +377,12 @@ declare type SemaphorSqlIntent = {
 
 declare type SemaphorTimeGrain = 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'year';
 
+declare type SemaphorTimeWindow = {
+    unit: 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'year';
+    value: number;
+    anchor?: 'now' | 'latest_available';
+};
+
 export declare function toSemaphorActiveInputSnapshots(inputs: SemaphorDataAppInputReference[] | undefined): SemaphorDataAppInputSnapshot[];
 
 export declare function toSemaphorInputBinding(input: SemaphorDataAppInputReference): SemaphorInputBinding;

package/dist/types/main.d.ts

@@ -1778,13 +1778,15 @@ declare type DashboardCardQueryFieldRef = {
 };
 
 declare type DashboardCardQueryIntent = {
-    metric?: string;
     metrics?: string[];
+    primaryMetric?: string;
+    metricRefs?: DashboardCardQueryFieldRef[];
     dateField?: string;
     dateFieldRef?: DashboardCardQueryFieldRef;
     timeGrain?: 'day' | 'week' | 'month' | 'quarter' | 'year';
     dimensions?: string[];
     dimensionRefs?: DashboardCardQueryFieldRef[];
+    filters?: SemaphorAnalyticsFilter[];
     limit?: number;
 };
 
@@ -4415,6 +4417,16 @@ declare type SemanticExecutionPayload = {
     }>;
 };
 
+declare type SemaphorAnalyticsFilter = {
+    id?: string;
+    field: SemaphorFieldRef;
+    operator?: SemaphorAnalyticsFilterOperator;
+    value?: unknown;
+    values?: unknown[];
+};
+
+declare type SemaphorAnalyticsFilterOperator = SemaphorInputOperator | 'not_contains' | 'is_null' | 'is_not_null';
+
 declare type SemaphorAnalyticsIntent = SemaphorMetricIntent | SemaphorRecordsIntent | SemaphorInputOptionsIntent | SemaphorSqlIntent;
 
 export declare const SemaphorContextProvider: ({ children, dashboardProps, }: {
@@ -4437,6 +4449,8 @@ declare type SemaphorInputBinding = {
     field?: SemaphorFieldRef;
 };
 
+declare type SemaphorInputOperator = '=' | '!=' | 'in' | 'not_in' | 'contains' | 'between' | 'not_between' | '>' | '>=' | '<' | '<=';
+
 declare type SemaphorInputOptionsIntent = {
     kind: 'inputOptions';
     version?: SemaphorProtocolVersion;
@@ -4448,21 +4462,32 @@ declare type SemaphorInputOptionsIntent = {
     limit?: number;
 };
 
+declare type SemaphorMetricAnalysis = {
+    kind: 'period_change';
+    orderBy?: 'absolute_change' | 'positive_change' | 'negative_change';
+    direction?: 'increase' | 'decrease' | 'both';
+    timeWindow?: SemaphorTimeWindow;
+};
+
 declare type SemaphorMetricIntent = {
     kind: 'metric';
     version?: SemaphorProtocolVersion;
     id?: string;
     source: SemaphorSourceRef;
-    metric: string;
-    metrics?: string[];
+    metrics: string[];
+    primaryMetric?: string;
+    metricRefs?: SemaphorFieldRef[];
     label?: string;
     dateField?: SemaphorFieldRef;
     timeGrain?: SemaphorTimeGrain;
+    timeWindow?: SemaphorTimeWindow;
     dimensions?: SemaphorFieldRef[];
+    filters?: SemaphorAnalyticsFilter[];
     comparison?: {
         kind: 'previous_period' | 'previous_year' | 'target';
         targetValue?: number;
     };
+    analysis?: SemaphorMetricAnalysis;
     inputs?: SemaphorInputBinding[];
     limit?: number;
 };
@@ -4536,6 +4561,12 @@ declare type SemaphorSqlIntent = {
 
 declare type SemaphorTimeGrain = 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'year';
 
+declare type SemaphorTimeWindow = {
+    unit: 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'year';
+    value: number;
+    anchor?: 'now' | 'latest_available';
+};
+
 /**
  * Stable serializer for dashboard dirty checks.
  * This consolidates normalization + serialization into one call site, so

package/package.json

@@ -5,7 +5,7 @@
     "email": "support@semaphor.cloud"
   },
   "license": "MIT",
-  "version": "0.1.334",
+  "version": "0.1.336",
   "description": "Fully interactive and customizable dashboards for your apps.",
   "keywords": [
     "react",