@letpeoplework/lighthouse-mcp-core 1.7.1 → 1.8.0

package/dist/index.d.cts

@@ -1,557 +1,692 @@
-import { DeliveryMetricsHistory } from '@letpeoplework/lighthouse-client';
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-
-type McpCorePackageContract = {
-    readonly name: "@letpeoplework/lighthouse-mcp-core";
-    readonly dependsOn: "@letpeoplework/lighthouse-client";
-    readonly transports: readonly ["stdio", "streamable-http"];
-};
-declare const getMcpCorePackageContract: () => McpCorePackageContract;
+import { DeliveryMetricsHistory, LighthouseApiResult, LighthouseClient, LighthouseVoterKeyStore, RefinementMomentFacts, RefinementWordingSource, TeamRefinement, UsageDataOccurrence, UsageDataQuestionAnswer, UsageDataStep, VotedRow } from "@letpeoplework/lighthouse-client";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import "zod";
+import { ElicitRequestFormParams, ElicitResult } from "@modelcontextprotocol/sdk/types.js";
+//#region src/toolResult.d.ts
 type McpToolContent = {
-    readonly type: "text";
-    readonly text: string;
+  readonly type: "text";
+  readonly text: string;
 };
 type McpToolResult = {
-    readonly isError: boolean;
-    readonly content: readonly McpToolContent[];
+  readonly isError: boolean;
+  readonly content: readonly McpToolContent[];
 };
-type McpToolDefinition = {
-    readonly name: "lighthouse_health_check" | "lighthouse_version_get" | "lighthouse_worktracking_list" | "lighthouse_worktracking_get" | "lighthouse_team_list" | "lighthouse_team_get" | "lighthouse_team_refresh" | "lighthouse_portfolio_list" | "lighthouse_portfolio_get" | "lighthouse_portfolio_refresh" | "lighthouse_team_metrics_throughput" | "lighthouse_team_metrics_cycleTimePercentiles" | "lighthouse_team_metrics_workItemAgePercentiles" | "lighthouse_portfolio_metrics_workItemAgePercentiles" | "lighthouse_team_metrics_workItemAge" | "lighthouse_team_metrics_totalWorkItemAge" | "lighthouse_portfolio_metrics_throughput" | "lighthouse_portfolio_metrics_workItemAge" | "lighthouse_portfolio_metrics_totalWorkItemAge" | "lighthouse_team_metrics_blockedCountHistory" | "lighthouse_portfolio_metrics_blockedCountHistory" | "lighthouse_team_metrics_percentilesOverTime" | "lighthouse_portfolio_metrics_percentilesOverTime" | "lighthouse_team_metrics_processBehaviorOverTime" | "lighthouse_portfolio_metrics_processBehaviorOverTime" | "lighthouse_team_metrics_cumulativeStateTime" | "lighthouse_team_metrics_cumulativeStateTimeItems" | "lighthouse_team_metrics_cumulativeStateTimeCandidates" | "lighthouse_portfolio_metrics_cumulativeStateTime" | "lighthouse_portfolio_metrics_cumulativeStateTimeItems" | "lighthouse_portfolio_metrics_cumulativeStateTimeCandidates" | "lighthouse_feature_get" | "lighthouse_feature_workitems" | "lighthouse_delivery_list" | "lighthouse_delivery_metrics" | "lighthouse_blackout_list" | "lighthouse_blackout_create" | "lighthouse_blackout_update" | "lighthouse_blackout_delete" | "lighthouse_forecast_manual" | "lighthouse_forecast_backtest";
-    readonly description: string;
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: Record<string, unknown>;
-        readonly required?: readonly string[];
-        readonly additionalProperties: false;
-    };
+//#endregion
+//#region src/usageDataPort.d.ts
+/**
+ * Where a tool call's usage data goes once its result is in hand. The promise resolves when the result may
+ * be returned: after the question, when this call puts it, and never after a send.
+ */
+export type McpUsageDataPort = (step: UsageDataStep) => Promise<void>;
+export declare const USAGE_DATA_ELICITATION_MESSAGE: string;
+export declare const USAGE_DATA_QUESTION_TIMEOUT_MS = 50000;
+/** Sends one elicitation to the assistant, as part of the tool call being answered. */
+export type SendElicitation = (params: ElicitRequestFormParams, options: {
+  readonly timeout: number;
+}) => Promise<Pick<ElicitResult, "action">>;
+/**
+ * Puts the usage data question through the assistant. Accepting is a yes and declining a No; a cancel, a
+ * closed question, an error or no answer in time is no answer at all.
+ */
+export declare const askThroughTheAssistant: (send: SendElicitation) => () => Promise<UsageDataQuestionAnswer>;
+export type AskingOnceDependencies = {
+  /** Whether a question could still be due: nothing kept for this Lighthouse and nothing forbids asking. */
+  readonly mightAsk: () => Promise<boolean>;
+  /** Settles one call's usage data; never expected to throw. */
+  readonly settle: (step: UsageDataStep) => Promise<unknown>;
+  readonly now?: () => Date;
 };
-type McpRuntimeClient = {
-    readonly checkConnectivity: () => Promise<{
-        readonly category: "success" | "unreachable" | "misconfigured" | "unauthorized" | "dependency-failure" | "concurrency-conflict" | "unexpected";
-        readonly reason?: string;
-    }>;
-    readonly getVersion: () => Promise<{
-        readonly ok: true;
-        readonly value: string;
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly listWorkTrackingConnections: () => Promise<{
-        readonly ok: true;
-        readonly value: readonly unknown[];
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly getWorkTrackingConnection: (id: number) => Promise<{
-        readonly ok: true;
-        readonly value: unknown;
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly listTeams: () => Promise<{
-        readonly ok: true;
-        readonly value: readonly unknown[];
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly getTeam: (id: number) => Promise<{
-        readonly ok: true;
-        readonly value: unknown;
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly refreshTeam: (id: number) => Promise<{
-        readonly ok: true;
-        readonly value: unknown;
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly listPortfolios: () => Promise<{
-        readonly ok: true;
-        readonly value: readonly unknown[];
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly getPortfolio: (id: number) => Promise<{
-        readonly ok: true;
-        readonly value: unknown;
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly refreshPortfolio: (id: number) => Promise<{
-        readonly ok: true;
-        readonly value: unknown;
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly getTeamThroughput: (id: number, range?: {
-        readonly startDate: string;
-        readonly endDate: string;
-    }, view?: "raw" | "filtered") => Promise<{
-        readonly ok: true;
-        readonly value: unknown;
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly getTeamCycleTimePercentiles: (id: number, range?: {
-        readonly startDate: string;
-        readonly endDate: string;
-    }, definitionId?: number) => Promise<{
-        readonly ok: true;
-        readonly value: readonly unknown[];
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly getTeamWorkItemAgePercentiles: (id: number, range?: {
-        readonly startDate: string;
-        readonly endDate: string;
-    }) => Promise<{
-        readonly ok: true;
-        readonly value: readonly unknown[];
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly getPortfolioWorkItemAgePercentiles: (id: number, range?: {
-        readonly startDate: string;
-        readonly endDate: string;
-    }) => Promise<{
-        readonly ok: true;
-        readonly value: readonly unknown[];
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly getPortfolioThroughput: (id: number, range?: {
-        readonly startDate: string;
-        readonly endDate: string;
-    }) => Promise<{
-        readonly ok: true;
-        readonly value: unknown;
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly getTeamWorkItemAgeOverTime: (id: number, range?: {
-        readonly startDate: string;
-        readonly endDate: string;
-    }) => Promise<{
-        readonly ok: true;
-        readonly value: unknown;
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly getTeamTotalWorkItemAgeOverTime: (id: number, range?: {
-        readonly startDate: string;
-        readonly endDate: string;
-    }) => Promise<{
-        readonly ok: true;
-        readonly value: unknown;
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly getPortfolioWorkItemAgeOverTime: (id: number, range?: {
-        readonly startDate: string;
-        readonly endDate: string;
-    }) => Promise<{
-        readonly ok: true;
-        readonly value: unknown;
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly getPortfolioTotalWorkItemAgeOverTime: (id: number, range?: {
-        readonly startDate: string;
-        readonly endDate: string;
-    }) => Promise<{
-        readonly ok: true;
-        readonly value: unknown;
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly getTeamBlockedCountHistory: (id: number, range?: {
-        readonly startDate: string;
-        readonly endDate: string;
-    }) => Promise<{
-        readonly ok: true;
-        readonly value: readonly unknown[];
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly getPortfolioBlockedCountHistory: (id: number, range?: {
-        readonly startDate: string;
-        readonly endDate: string;
-    }) => Promise<{
-        readonly ok: true;
-        readonly value: readonly unknown[];
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly getTeamPercentilesOverTime: (id: number, range?: {
-        readonly startDate: string;
-        readonly endDate: string;
-    }, metricType?: "CycleTime" | "WorkItemAge", horizon?: number) => Promise<{
-        readonly ok: true;
-        readonly value: readonly unknown[];
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly getPortfolioPercentilesOverTime: (id: number, range?: {
-        readonly startDate: string;
-        readonly endDate: string;
-    }, metricType?: "CycleTime" | "WorkItemAge", horizon?: number) => Promise<{
-        readonly ok: true;
-        readonly value: readonly unknown[];
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly getTeamProcessBehaviorOverTime: (id: number, range?: {
-        readonly startDate: string;
-        readonly endDate: string;
-    }, metricType?: "Throughput" | "WorkItemAge" | "Wip" | "CycleTime" | "Arrivals" | "FeatureSize") => Promise<{
-        readonly ok: true;
-        readonly value: readonly unknown[];
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly getPortfolioProcessBehaviorOverTime: (id: number, range?: {
-        readonly startDate: string;
-        readonly endDate: string;
-    }, metricType?: "Throughput" | "WorkItemAge" | "Wip" | "CycleTime" | "Arrivals" | "FeatureSize") => Promise<{
-        readonly ok: true;
-        readonly value: readonly unknown[];
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly getTeamCumulativeStateTime: (id: number, range?: {
-        readonly startDate: string;
-        readonly endDate: string;
-    }, itemIds?: readonly number[]) => Promise<{
-        readonly ok: true;
-        readonly value: unknown;
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly getTeamCumulativeStateTimeItems: (id: number, state: string, range?: {
-        readonly startDate: string;
-        readonly endDate: string;
-    }, itemIds?: readonly number[]) => Promise<{
-        readonly ok: true;
-        readonly value: unknown;
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly getTeamCumulativeStateTimeCandidates: (id: number, range?: {
-        readonly startDate: string;
-        readonly endDate: string;
-    }) => Promise<{
-        readonly ok: true;
-        readonly value: unknown;
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly getPortfolioCumulativeStateTime: (id: number, range?: {
-        readonly startDate: string;
-        readonly endDate: string;
-    }, itemIds?: readonly number[]) => Promise<{
-        readonly ok: true;
-        readonly value: unknown;
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly getPortfolioCumulativeStateTimeItems: (id: number, state: string, range?: {
-        readonly startDate: string;
-        readonly endDate: string;
-    }, itemIds?: readonly number[]) => Promise<{
-        readonly ok: true;
-        readonly value: unknown;
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly getPortfolioCumulativeStateTimeCandidates: (id: number, range?: {
-        readonly startDate: string;
-        readonly endDate: string;
-    }) => Promise<{
-        readonly ok: true;
-        readonly value: unknown;
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly getFeaturesByIds: (ids: readonly number[]) => Promise<{
-        readonly ok: true;
-        readonly value: readonly unknown[];
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly getFeaturesByReferences: (refs: readonly string[]) => Promise<{
-        readonly ok: true;
-        readonly value: readonly unknown[];
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly getFeatureWorkItems: (featureId: number) => Promise<{
-        readonly ok: true;
-        readonly value: readonly unknown[];
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly listDeliveries: (portfolioId: number) => Promise<{
-        readonly ok: true;
-        readonly value: readonly unknown[];
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly getDeliveryMetricsHistory: (deliveryId: number) => Promise<{
-        readonly ok: true;
-        readonly value: DeliveryMetricsHistory;
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly createDelivery: (portfolioId: number, payload: Readonly<Record<string, unknown>>) => Promise<{
-        readonly ok: true;
-        readonly value: unknown;
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly updateDelivery: (deliveryId: number, payload: Readonly<Record<string, unknown>>) => Promise<{
-        readonly ok: true;
-        readonly value: unknown;
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly deleteDelivery: (deliveryId: number) => Promise<{
-        readonly ok: true;
-        readonly value: undefined;
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly getRecurringBlackoutRules: () => Promise<{
-        readonly ok: true;
-        readonly value: readonly unknown[];
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly createRecurringBlackoutRule: (payload: Readonly<Record<string, unknown>>) => Promise<{
-        readonly ok: true;
-        readonly value: unknown;
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly updateRecurringBlackoutRule: (id: number, payload: Readonly<Record<string, unknown>>) => Promise<{
-        readonly ok: true;
-        readonly value: unknown;
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly deleteRecurringBlackoutRule: (id: number) => Promise<{
-        readonly ok: true;
-        readonly value: undefined;
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly runManualForecast: (teamId: number, payload: {
-        readonly remainingItems?: number;
-        readonly targetDate?: string;
-        readonly applyFilterOverride?: boolean;
-    }) => Promise<{
-        readonly ok: true;
-        readonly value: unknown;
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
-    readonly runBacktest: (teamId: number, payload: {
-        readonly startDate: string;
-        readonly endDate: string;
-        readonly historicalStartDate: string;
-        readonly historicalEndDate: string;
-        readonly applyFilterOverride?: boolean;
-    }) => Promise<{
-        readonly ok: true;
-        readonly value: unknown;
-    } | {
-        readonly ok: false;
-        readonly error: {
-            readonly category: string;
-            readonly reason: string;
-        };
-    }>;
+/**
+ * A port that puts the question at most once in this process. Only a call that might ask waits for its
+ * step; every other call, and every call once the question has been put, hands its step over and returns.
+ * Calls that reach the question while it is being put get no answer at once rather than a second question.
+ */
+export declare const askingOnceInThisProcess: (dependencies: AskingOnceDependencies) => McpUsageDataPort;
+/** What a tool call that succeeded did that the web counts too. */
+export declare const usageDataOccurrencesOf: (toolName: string) => readonly UsageDataOccurrence[];
+/** A tool's result with what it did that the web counts too; a result that is an error counts nothing. */
+export type CountedToolResult = {
+  readonly result: McpToolResult;
+  readonly occurrences: readonly UsageDataOccurrence[];
+};
+export declare const countedToolResult: (result: McpToolResult, occurrences: readonly UsageDataOccurrence[]) => CountedToolResult;
+/**
+ * A vote Lighthouse took, at the moment the Refinement read before it says, and the Work Item becoming
+ * Ready when only Lighthouse's answer can say this vote made it so.
+ */
+export declare const usageDataOccurrencesOfAVote: (readBeforeTheVote: RefinementMomentFacts, answered: LighthouseApiResult<Pick<VotedRow, "madeReady">>) => readonly UsageDataOccurrence[];
+/** The verdict a Refinement Lighthouse answered shows, when it is a Refinement day's. */
+export declare const usageDataOccurrencesOfARead: (answered: LighthouseApiResult<Pick<TeamRefinement, "isRefinementDay" | "workItems" | "need">>) => readonly UsageDataOccurrence[];
+//#endregion
+//#region src/refinementTools.d.ts
+/** The voter key one MCP server keeps for the one Lighthouse it talks to. */
+type McpVoterKeyStore = LighthouseVoterKeyStore;
+type RefinementToolDependencies = {
+  /** Where a local server keeps its voter key; a server shared by many people keeps none. */
+  readonly voterKeyStore?: McpVoterKeyStore;
+  /** Why this server may not vote, comment or take back right now, or null when it may. */
+  readonly refuseVoting?: () => Promise<string | null>;
+  /** What to say when Lighthouse asks for a voter key, on a server that keeps none to send. */
+  readonly voterKeyRequired?: string;
 };
-type McpCoreRuntimeDependencies = {
-    readonly createClient: () => McpRuntimeClient;
+type ToolError = {
+  readonly category: string;
+  readonly reason: string;
+};
+type RefinementToolClient = RefinementWordingSource<ToolError> & Pick<LighthouseClient, "getTeamRefinement" | "castRefinementVote" | "addRefinementComment" | "takeBackRefinementVote" | "getRefinementLog" | "getTerminology">;
+//#endregion
+//#region src/index.d.ts
+export type McpCorePackageContract = {
+  readonly name: "@letpeoplework/lighthouse-mcp-core";
+  readonly dependsOn: "@letpeoplework/lighthouse-client";
+  readonly transports: readonly ["stdio", "streamable-http"];
+};
+export declare const getMcpCorePackageContract: () => McpCorePackageContract;
+export type McpToolDefinition = {
+  readonly name: "lighthouse_health_check" | "lighthouse_version_get" | "lighthouse_worktracking_list" | "lighthouse_worktracking_get" | "lighthouse_team_list" | "lighthouse_team_get" | "lighthouse_team_refresh" | "lighthouse_team_refinement_get" | "lighthouse_team_refinement_vote" | "lighthouse_team_refinement_comment" | "lighthouse_team_refinement_voteTakeBack" | "lighthouse_portfolio_list" | "lighthouse_portfolio_get" | "lighthouse_portfolio_refresh" | "lighthouse_team_metrics_throughput" | "lighthouse_team_metrics_cycleTimePercentiles" | "lighthouse_team_metrics_workItemAgePercentiles" | "lighthouse_portfolio_metrics_workItemAgePercentiles" | "lighthouse_team_metrics_workItemAge" | "lighthouse_team_metrics_totalWorkItemAge" | "lighthouse_portfolio_metrics_throughput" | "lighthouse_portfolio_metrics_workItemAge" | "lighthouse_portfolio_metrics_totalWorkItemAge" | "lighthouse_team_metrics_blockedCountHistory" | "lighthouse_portfolio_metrics_blockedCountHistory" | "lighthouse_team_metrics_wip" | "lighthouse_team_metrics_sleRisk" | "lighthouse_team_metrics_processBehaviorChart" | "lighthouse_portfolio_metrics_processBehaviorChart" | "lighthouse_team_metrics_percentilesOverTime" | "lighthouse_portfolio_metrics_percentilesOverTime" | "lighthouse_team_metrics_processBehaviorOverTime" | "lighthouse_portfolio_metrics_processBehaviorOverTime" | "lighthouse_team_metrics_cumulativeStateTime" | "lighthouse_team_metrics_cumulativeStateTimeItems" | "lighthouse_team_metrics_cumulativeStateTimeCandidates" | "lighthouse_portfolio_metrics_cumulativeStateTime" | "lighthouse_portfolio_metrics_cumulativeStateTimeItems" | "lighthouse_portfolio_metrics_cumulativeStateTimeCandidates" | "lighthouse_feature_get" | "lighthouse_feature_workitems" | "lighthouse_delivery_list" | "lighthouse_delivery_metrics" | "lighthouse_blackout_list" | "lighthouse_blackout_create" | "lighthouse_blackout_update" | "lighthouse_blackout_delete" | "lighthouse_forecast_manual" | "lighthouse_forecast_backtest";
+  readonly description: string;
+  readonly inputSchema: {
+    readonly type: "object";
+    readonly properties: Record<string, unknown>;
+    readonly required?: readonly string[];
+    readonly additionalProperties: false;
+  };
+};
+declare const processBehaviorMetricTypes: readonly ["Throughput", "WorkItemAge", "Wip", "CycleTime", "Arrivals", "FeatureSize"];
+declare const TEAM_CHART_TYPES: readonly ["Throughput", "WorkItemAge", "Wip", "CycleTime", "Arrivals"];
+type TeamChartType = (typeof TEAM_CHART_TYPES)[number];
+type McpRuntimeClient = {
+  readonly checkConnectivity: () => Promise<{
+    readonly category: "success" | "unreachable" | "misconfigured" | "unauthorized" | "dependency-failure" | "concurrency-conflict" | "unexpected";
+    readonly reason?: string;
+  }>;
+  readonly getVersion: () => Promise<{
+    readonly ok: true;
+    readonly value: string;
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly listWorkTrackingConnections: () => Promise<{
+    readonly ok: true;
+    readonly value: readonly unknown[];
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly getWorkTrackingConnection: (id: number) => Promise<{
+    readonly ok: true;
+    readonly value: unknown;
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly listTeams: () => Promise<{
+    readonly ok: true;
+    readonly value: readonly unknown[];
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly getTeamSettings: (id: number) => Promise<{
+    readonly ok: true;
+    readonly value: unknown;
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly getTeam: (id: number) => Promise<{
+    readonly ok: true;
+    readonly value: unknown;
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly refreshTeam: (id: number) => Promise<{
+    readonly ok: true;
+    readonly value: unknown;
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly listPortfolios: () => Promise<{
+    readonly ok: true;
+    readonly value: readonly unknown[];
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly getPortfolio: (id: number) => Promise<{
+    readonly ok: true;
+    readonly value: unknown;
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly refreshPortfolio: (id: number) => Promise<{
+    readonly ok: true;
+    readonly value: unknown;
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly getTeamThroughput: (id: number, range?: {
+    readonly startDate: string;
+    readonly endDate: string;
+  }, view?: "raw" | "filtered") => Promise<{
+    readonly ok: true;
+    readonly value: unknown;
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly getTeamCycleTimePercentiles: (id: number, range?: {
+    readonly startDate: string;
+    readonly endDate: string;
+  }, definitionId?: number) => Promise<{
+    readonly ok: true;
+    readonly value: readonly unknown[];
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly getTeamWorkItemAgePercentiles: (id: number, range?: {
+    readonly startDate: string;
+    readonly endDate: string;
+  }) => Promise<{
+    readonly ok: true;
+    readonly value: readonly unknown[];
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly getPortfolioWorkItemAgePercentiles: (id: number, range?: {
+    readonly startDate: string;
+    readonly endDate: string;
+  }) => Promise<{
+    readonly ok: true;
+    readonly value: readonly unknown[];
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly getPortfolioThroughput: (id: number, range?: {
+    readonly startDate: string;
+    readonly endDate: string;
+  }) => Promise<{
+    readonly ok: true;
+    readonly value: unknown;
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly getTeamWorkItemAgeOverTime: (id: number, range?: {
+    readonly startDate: string;
+    readonly endDate: string;
+  }) => Promise<{
+    readonly ok: true;
+    readonly value: unknown;
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly getTeamTotalWorkItemAgeOverTime: (id: number, range?: {
+    readonly startDate: string;
+    readonly endDate: string;
+  }) => Promise<{
+    readonly ok: true;
+    readonly value: unknown;
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly getPortfolioWorkItemAgeOverTime: (id: number, range?: {
+    readonly startDate: string;
+    readonly endDate: string;
+  }) => Promise<{
+    readonly ok: true;
+    readonly value: unknown;
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly getPortfolioTotalWorkItemAgeOverTime: (id: number, range?: {
+    readonly startDate: string;
+    readonly endDate: string;
+  }) => Promise<{
+    readonly ok: true;
+    readonly value: unknown;
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly getTeamBlockedCountHistory: (id: number, range?: {
+    readonly startDate: string;
+    readonly endDate: string;
+  }) => Promise<{
+    readonly ok: true;
+    readonly value: readonly unknown[];
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly getTeamWip: (id: number, asOfDate: string) => Promise<{
+    readonly ok: true;
+    readonly value: readonly unknown[];
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly getTeamProcessBehaviorChart: (id: number, range: {
+    readonly startDate: string;
+    readonly endDate: string;
+  }, metricType: TeamChartType) => Promise<{
+    readonly ok: true;
+    readonly value: unknown;
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly getPortfolioProcessBehaviorChart: (id: number, range: {
+    readonly startDate: string;
+    readonly endDate: string;
+  }, metricType: ProcessBehaviorMetricTypeArgument) => Promise<{
+    readonly ok: true;
+    readonly value: unknown;
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly getTeamSleRisk: (id: number) => Promise<{
+    readonly ok: true;
+    readonly value: readonly unknown[];
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly getPortfolioBlockedCountHistory: (id: number, range?: {
+    readonly startDate: string;
+    readonly endDate: string;
+  }) => Promise<{
+    readonly ok: true;
+    readonly value: readonly unknown[];
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly getTeamPercentilesOverTime: (id: number, range?: {
+    readonly startDate: string;
+    readonly endDate: string;
+  }, metricType?: "CycleTime" | "WorkItemAge", horizon?: number) => Promise<{
+    readonly ok: true;
+    readonly value: readonly unknown[];
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly getPortfolioPercentilesOverTime: (id: number, range?: {
+    readonly startDate: string;
+    readonly endDate: string;
+  }, metricType?: "CycleTime" | "WorkItemAge", horizon?: number) => Promise<{
+    readonly ok: true;
+    readonly value: readonly unknown[];
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly getTeamProcessBehaviorOverTime: (id: number, range?: {
+    readonly startDate: string;
+    readonly endDate: string;
+  }, metricType?: "Throughput" | "WorkItemAge" | "Wip" | "CycleTime" | "Arrivals" | "FeatureSize") => Promise<{
+    readonly ok: true;
+    readonly value: readonly unknown[];
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly getPortfolioProcessBehaviorOverTime: (id: number, range?: {
+    readonly startDate: string;
+    readonly endDate: string;
+  }, metricType?: "Throughput" | "WorkItemAge" | "Wip" | "CycleTime" | "Arrivals" | "FeatureSize") => Promise<{
+    readonly ok: true;
+    readonly value: readonly unknown[];
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly getTeamCumulativeStateTime: (id: number, range?: {
+    readonly startDate: string;
+    readonly endDate: string;
+  }, itemIds?: readonly number[]) => Promise<{
+    readonly ok: true;
+    readonly value: unknown;
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly getTeamCumulativeStateTimeItems: (id: number, state: string, range?: {
+    readonly startDate: string;
+    readonly endDate: string;
+  }, itemIds?: readonly number[]) => Promise<{
+    readonly ok: true;
+    readonly value: unknown;
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly getTeamCumulativeStateTimeCandidates: (id: number, range?: {
+    readonly startDate: string;
+    readonly endDate: string;
+  }) => Promise<{
+    readonly ok: true;
+    readonly value: unknown;
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly getPortfolioCumulativeStateTime: (id: number, range?: {
+    readonly startDate: string;
+    readonly endDate: string;
+  }, itemIds?: readonly number[]) => Promise<{
+    readonly ok: true;
+    readonly value: unknown;
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly getPortfolioCumulativeStateTimeItems: (id: number, state: string, range?: {
+    readonly startDate: string;
+    readonly endDate: string;
+  }, itemIds?: readonly number[]) => Promise<{
+    readonly ok: true;
+    readonly value: unknown;
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly getPortfolioCumulativeStateTimeCandidates: (id: number, range?: {
+    readonly startDate: string;
+    readonly endDate: string;
+  }) => Promise<{
+    readonly ok: true;
+    readonly value: unknown;
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly getFeaturesByIds: (ids: readonly number[]) => Promise<{
+    readonly ok: true;
+    readonly value: readonly unknown[];
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly getFeaturesByReferences: (refs: readonly string[]) => Promise<{
+    readonly ok: true;
+    readonly value: readonly unknown[];
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly getFeatureWorkItems: (featureId: number) => Promise<{
+    readonly ok: true;
+    readonly value: readonly unknown[];
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly listDeliveries: (portfolioId: number) => Promise<{
+    readonly ok: true;
+    readonly value: readonly unknown[];
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly getDeliveryMetricsHistory: (deliveryId: number) => Promise<{
+    readonly ok: true;
+    readonly value: DeliveryMetricsHistory;
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly createDelivery: (portfolioId: number, payload: Readonly<Record<string, unknown>>) => Promise<{
+    readonly ok: true;
+    readonly value: unknown;
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly updateDelivery: (deliveryId: number, payload: Readonly<Record<string, unknown>>) => Promise<{
+    readonly ok: true;
+    readonly value: unknown;
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly deleteDelivery: (deliveryId: number) => Promise<{
+    readonly ok: true;
+    readonly value: undefined;
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly getRecurringBlackoutRules: () => Promise<{
+    readonly ok: true;
+    readonly value: readonly unknown[];
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly createRecurringBlackoutRule: (payload: Readonly<Record<string, unknown>>) => Promise<{
+    readonly ok: true;
+    readonly value: unknown;
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly updateRecurringBlackoutRule: (id: number, payload: Readonly<Record<string, unknown>>) => Promise<{
+    readonly ok: true;
+    readonly value: unknown;
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly deleteRecurringBlackoutRule: (id: number) => Promise<{
+    readonly ok: true;
+    readonly value: undefined;
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly runManualForecast: (teamId: number, payload: {
+    readonly remainingItems?: number;
+    readonly targetDate?: string;
+    readonly applyFilterOverride?: boolean;
+  }) => Promise<{
+    readonly ok: true;
+    readonly value: unknown;
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+  readonly runBacktest: (teamId: number, payload: {
+    readonly startDate: string;
+    readonly endDate: string;
+    readonly historicalStartDate: string;
+    readonly historicalEndDate: string;
+    readonly applyFilterOverride?: boolean;
+  }) => Promise<{
+    readonly ok: true;
+    readonly value: unknown;
+  } | {
+    readonly ok: false;
+    readonly error: {
+      readonly category: string;
+      readonly reason: string;
+    };
+  }>;
+} & Omit<RefinementToolClient, "getTeam">;
+export type McpCoreRuntimeDependencies = {
+  readonly createClient: () => McpRuntimeClient;
+  /** Where usage data goes; without it a tool call does exactly what it always did. */
+  readonly usageData?: McpUsageDataPort;
+} & RefinementToolDependencies;
+export type McpCoreRuntime = {
+  readonly listTools: () => readonly McpToolDefinition[];
+  readonly callTool: (name: string, argumentsPayload: unknown) => Promise<McpToolResult>;
+  /** The tool's result with what it did that the web counts too. */
+  readonly callCountedTool: (name: string, argumentsPayload: unknown) => Promise<CountedToolResult>;
 };
-type McpCoreRuntime = {
-    readonly listTools: () => readonly McpToolDefinition[];
-    readonly callTool: (name: string, argumentsPayload: unknown) => Promise<McpToolResult>;
+type ProcessBehaviorMetricTypeArgument = (typeof processBehaviorMetricTypes)[number];
+export declare const createMcpCoreRuntime: (dependencies: McpCoreRuntimeDependencies) => McpCoreRuntime;
+/** The server, and through it what the assistant said it can do once it connected. */
+type McpToolServer = Pick<McpServer, "registerTool"> & {
+  readonly server?: Pick<McpServer["server"], "getClientCapabilities">;
 };
-declare const createMcpCoreRuntime: (dependencies: McpCoreRuntimeDependencies) => McpCoreRuntime;
-declare const registerMcpTools: (server: Pick<McpServer, "registerTool">, dependencies: McpCoreRuntimeDependencies) => void;
-
-export { type McpCorePackageContract, type McpCoreRuntime, type McpCoreRuntimeDependencies, type McpToolDefinition, type McpToolResult, createMcpCoreRuntime, getMcpCorePackageContract, registerMcpTools };
+export declare const registerMcpTools: (server: McpToolServer, dependencies: McpCoreRuntimeDependencies) => void;
+//#endregion
+export type { McpToolResult, McpVoterKeyStore };