@memberjunction/ng-dashboards 6.2.0-edge.5 → 6.2.0-edge.6

package/dist/AI/components/vectors/vector-store-selection.d.ts

@@ -0,0 +1,32 @@
+/** A vector index as the Vectors tab lists it. */
+export interface VectorIndexOption {
+    ID: string;
+    Name: string;
+    VectorDatabaseID: string;
+    EmbeddingModelID: string;
+}
+/** The three dropdowns' values. An empty `VectorIndexID` is "Auto (create/find matching index)". */
+export interface VectorStoreSelection {
+    EmbeddingModelID: string;
+    VectorDatabaseID: string;
+    VectorIndexID: string;
+}
+/** True when the index stores vectors in this database with this embedding model. */
+export declare function IndexMatchesSelection(index: VectorIndexOption, databaseID: string, embeddingModelID: string): boolean;
+/**
+ * The indexes the Vector Index dropdown offers: those in the selected database built with the
+ * selected embedding model. An index built with another model would override the model shown.
+ */
+export declare function IndexesForSelection(indexes: VectorIndexOption[], databaseID: string, embeddingModelID: string): VectorIndexOption[];
+/** The selection after the user picks an index: the model and database dropdowns follow it. */
+export declare function SelectIndex(selection: VectorStoreSelection, indexes: VectorIndexOption[], indexID: string): VectorStoreSelection;
+/** The selection after the user changes the database: a chosen index from another database goes back to Auto. */
+export declare function SelectDatabase(selection: VectorStoreSelection, indexes: VectorIndexOption[], databaseID: string): VectorStoreSelection;
+/** The selection after the user changes the model: a chosen index built with another model goes back to Auto. */
+export declare function SelectEmbeddingModel(selection: VectorStoreSelection, indexes: VectorIndexOption[], embeddingModelID: string): VectorStoreSelection;
+/**
+ * The index Save may use as chosen: the selected one, only when it matches the database and model
+ * shown. Null means Auto (find or create the index for that database and model).
+ */
+export declare function ChosenIndexForSave(selection: VectorStoreSelection, indexes: VectorIndexOption[]): VectorIndexOption | null;
+//# sourceMappingURL=vector-store-selection.d.ts.map

package/dist/AI/components/vectors/vector-store-selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-store-selection.d.ts","sourceRoot":"","sources":["../../../../src/AI/components/vectors/vector-store-selection.ts"],"names":[],"mappings":"AAgBA,kDAAkD;AAClD,MAAM,WAAW,iBAAiB;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;CAC5B;AAED,oGAAoG;AACpG,MAAM,WAAW,oBAAoB;IACjC,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;CACzB;AAED,qFAAqF;AACrF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAErH;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAEnI;AAED,+FAA+F;AAC/F,wBAAgB,WAAW,CAAC,SAAS,EAAE,oBAAoB,EAAE,OAAO,EAAE,iBAAiB,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,oBAAoB,CAMhI;AAED,iHAAiH;AACjH,wBAAgB,cAAc,CAAC,SAAS,EAAE,oBAAoB,EAAE,OAAO,EAAE,iBAAiB,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,oBAAoB,CAEtI;AAED,iHAAiH;AACjH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,oBAAoB,EAAE,OAAO,EAAE,iBAAiB,EAAE,EAAE,gBAAgB,EAAE,MAAM,GAAG,oBAAoB,CAElJ;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,oBAAoB,EAAE,OAAO,EAAE,iBAAiB,EAAE,GAAG,iBAAiB,GAAG,IAAI,CAM1H"}

package/dist/AI/components/vectors/vector-store-selection.js

@@ -0,0 +1,57 @@
+/**
+ * The Vectors tab's "where do this document's vectors go" choice: an embedding model, a vector
+ * database and an index. The three dropdowns must always show what Save will store.
+ *
+ * They did not. Save used a chosen index's database and model in place of the dropdowns' values,
+ * and the index stayed chosen when the database or model dropdown changed (the index list was
+ * filtered to the new database, so the stale choice was no longer even visible). With the first
+ * index pre-selected on load, a document saved with "gte-small" and the in-memory store showing
+ * was stored with another index's Pinecone database and Gemini model.
+ *
+ * These functions keep the three consistent: an index is offered only when it matches both the
+ * database and model shown, choosing one moves both dropdowns to its values, and changing either
+ * dropdown drops an index that no longer matches back to Auto.
+ */
+import { UUIDsEqual } from '@memberjunction/global';
+/** True when the index stores vectors in this database with this embedding model. */
+export function IndexMatchesSelection(index, databaseID, embeddingModelID) {
+    return UUIDsEqual(index.VectorDatabaseID, databaseID) && UUIDsEqual(index.EmbeddingModelID, embeddingModelID);
+}
+/**
+ * The indexes the Vector Index dropdown offers: those in the selected database built with the
+ * selected embedding model. An index built with another model would override the model shown.
+ */
+export function IndexesForSelection(indexes, databaseID, embeddingModelID) {
+    return indexes.filter(i => IndexMatchesSelection(i, databaseID, embeddingModelID));
+}
+/** The selection after the user picks an index: the model and database dropdowns follow it. */
+export function SelectIndex(selection, indexes, indexID) {
+    const index = indexID ? indexes.find(i => UUIDsEqual(i.ID, indexID)) : undefined;
+    if (!index) {
+        return { ...selection, VectorIndexID: '' };
+    }
+    return { EmbeddingModelID: index.EmbeddingModelID, VectorDatabaseID: index.VectorDatabaseID, VectorIndexID: index.ID };
+}
+/** The selection after the user changes the database: a chosen index from another database goes back to Auto. */
+export function SelectDatabase(selection, indexes, databaseID) {
+    return keepIndexOnlyIfItMatches({ ...selection, VectorDatabaseID: databaseID }, indexes);
+}
+/** The selection after the user changes the model: a chosen index built with another model goes back to Auto. */
+export function SelectEmbeddingModel(selection, indexes, embeddingModelID) {
+    return keepIndexOnlyIfItMatches({ ...selection, EmbeddingModelID: embeddingModelID }, indexes);
+}
+/**
+ * The index Save may use as chosen: the selected one, only when it matches the database and model
+ * shown. Null means Auto (find or create the index for that database and model).
+ */
+export function ChosenIndexForSave(selection, indexes) {
+    if (!selection.VectorIndexID) {
+        return null;
+    }
+    const index = indexes.find(i => UUIDsEqual(i.ID, selection.VectorIndexID));
+    return index && IndexMatchesSelection(index, selection.VectorDatabaseID, selection.EmbeddingModelID) ? index : null;
+}
+function keepIndexOnlyIfItMatches(selection, indexes) {
+    return ChosenIndexForSave(selection, indexes) ? selection : { ...selection, VectorIndexID: '' };
+}
+//# sourceMappingURL=vector-store-selection.js.map

package/dist/AI/components/vectors/vector-store-selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-store-selection.js","sourceRoot":"","sources":["../../../../src/AI/components/vectors/vector-store-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAiBpD,qFAAqF;AACrF,MAAM,UAAU,qBAAqB,CAAC,KAAwB,EAAE,UAAkB,EAAE,gBAAwB;IACxG,OAAO,UAAU,CAAC,KAAK,CAAC,gBAAgB,EAAE,UAAU,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,CAAC;AAClH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAA4B,EAAE,UAAkB,EAAE,gBAAwB;IAC1G,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,qBAAqB,CAAC,CAAC,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC,CAAC;AACvF,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,WAAW,CAAC,SAA+B,EAAE,OAA4B,EAAE,OAAe;IACtG,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACjF,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,OAAO,EAAE,GAAG,SAAS,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC;IAC/C,CAAC;IACD,OAAO,EAAE,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,EAAE,aAAa,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;AAC3H,CAAC;AAED,iHAAiH;AACjH,MAAM,UAAU,cAAc,CAAC,SAA+B,EAAE,OAA4B,EAAE,UAAkB;IAC5G,OAAO,wBAAwB,CAAC,EAAE,GAAG,SAAS,EAAE,gBAAgB,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,CAAC;AAC7F,CAAC;AAED,iHAAiH;AACjH,MAAM,UAAU,oBAAoB,CAAC,SAA+B,EAAE,OAA4B,EAAE,gBAAwB;IACxH,OAAO,wBAAwB,CAAC,EAAE,GAAG,SAAS,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,EAAE,OAAO,CAAC,CAAC;AACnG,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAA+B,EAAE,OAA4B;IAC5F,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC;IAC3E,OAAO,KAAK,IAAI,qBAAqB,CAAC,KAAK,EAAE,SAAS,CAAC,gBAAgB,EAAE,SAAS,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AACxH,CAAC;AAED,SAAS,wBAAwB,CAAC,SAA+B,EAAE,OAA4B;IAC3F,OAAO,kBAAkB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC;AACpG,CAAC","sourcesContent":["/**\n * The Vectors tab's \"where do this document's vectors go\" choice: an embedding model, a vector\n * database and an index. The three dropdowns must always show what Save will store.\n *\n * They did not. Save used a chosen index's database and model in place of the dropdowns' values,\n * and the index stayed chosen when the database or model dropdown changed (the index list was\n * filtered to the new database, so the stale choice was no longer even visible). With the first\n * index pre-selected on load, a document saved with \"gte-small\" and the in-memory store showing\n * was stored with another index's Pinecone database and Gemini model.\n *\n * These functions keep the three consistent: an index is offered only when it matches both the\n * database and model shown, choosing one moves both dropdowns to its values, and changing either\n * dropdown drops an index that no longer matches back to Auto.\n */\nimport { UUIDsEqual } from '@memberjunction/global';\n\n/** A vector index as the Vectors tab lists it. */\nexport interface VectorIndexOption {\n    ID: string;\n    Name: string;\n    VectorDatabaseID: string;\n    EmbeddingModelID: string;\n}\n\n/** The three dropdowns' values. An empty `VectorIndexID` is \"Auto (create/find matching index)\". */\nexport interface VectorStoreSelection {\n    EmbeddingModelID: string;\n    VectorDatabaseID: string;\n    VectorIndexID: string;\n}\n\n/** True when the index stores vectors in this database with this embedding model. */\nexport function IndexMatchesSelection(index: VectorIndexOption, databaseID: string, embeddingModelID: string): boolean {\n    return UUIDsEqual(index.VectorDatabaseID, databaseID) && UUIDsEqual(index.EmbeddingModelID, embeddingModelID);\n}\n\n/**\n * The indexes the Vector Index dropdown offers: those in the selected database built with the\n * selected embedding model. An index built with another model would override the model shown.\n */\nexport function IndexesForSelection(indexes: VectorIndexOption[], databaseID: string, embeddingModelID: string): VectorIndexOption[] {\n    return indexes.filter(i => IndexMatchesSelection(i, databaseID, embeddingModelID));\n}\n\n/** The selection after the user picks an index: the model and database dropdowns follow it. */\nexport function SelectIndex(selection: VectorStoreSelection, indexes: VectorIndexOption[], indexID: string): VectorStoreSelection {\n    const index = indexID ? indexes.find(i => UUIDsEqual(i.ID, indexID)) : undefined;\n    if (!index) {\n        return { ...selection, VectorIndexID: '' };\n    }\n    return { EmbeddingModelID: index.EmbeddingModelID, VectorDatabaseID: index.VectorDatabaseID, VectorIndexID: index.ID };\n}\n\n/** The selection after the user changes the database: a chosen index from another database goes back to Auto. */\nexport function SelectDatabase(selection: VectorStoreSelection, indexes: VectorIndexOption[], databaseID: string): VectorStoreSelection {\n    return keepIndexOnlyIfItMatches({ ...selection, VectorDatabaseID: databaseID }, indexes);\n}\n\n/** The selection after the user changes the model: a chosen index built with another model goes back to Auto. */\nexport function SelectEmbeddingModel(selection: VectorStoreSelection, indexes: VectorIndexOption[], embeddingModelID: string): VectorStoreSelection {\n    return keepIndexOnlyIfItMatches({ ...selection, EmbeddingModelID: embeddingModelID }, indexes);\n}\n\n/**\n * The index Save may use as chosen: the selected one, only when it matches the database and model\n * shown. Null means Auto (find or create the index for that database and model).\n */\nexport function ChosenIndexForSave(selection: VectorStoreSelection, indexes: VectorIndexOption[]): VectorIndexOption | null {\n    if (!selection.VectorIndexID) {\n        return null;\n    }\n    const index = indexes.find(i => UUIDsEqual(i.ID, selection.VectorIndexID));\n    return index && IndexMatchesSelection(index, selection.VectorDatabaseID, selection.EmbeddingModelID) ? index : null;\n}\n\nfunction keepIndexOnlyIfItMatches(selection: VectorStoreSelection, indexes: VectorIndexOption[]): VectorStoreSelection {\n    return ChosenIndexForSave(selection, indexes) ? selection : { ...selection, VectorIndexID: '' };\n}\n"]}

package/dist/ChiefOfStaff/chief-of-staff-agent-context.d.ts

@@ -0,0 +1,236 @@
+/**
+ * Pure, unit-testable helpers for the "My Chief of Staff" Executive Cockpit's
+ * agent context + client tools.
+ *
+ * 🚨 SAFETY BOUNDARY 🚨
+ * The Chief of Staff Cockpit exposes ONLY navigation / tab-switch / filter / search /
+ * refresh / detail-view tools to the co-agent. DELIBERATELY NOT exposed as client tools
+ * (mutations stay human-driven in the UI):
+ * - Approving or rejecting `MJ: AI Agent Requests`
+ * - Modifying or saving `MJ: AI Agent User Policies` governance toggles / thresholds
+ * - Triggering "Wake Now" or pausing/resuming `MJ: User Routines`
+ *
+ * Published context exposes only aggregate counts, active tab/filter state, governance
+ * mode summaries, and bounded display names (capped at 25) — never raw request payloads,
+ * custom instructions overrides, or private message content.
+ */
+import type { MJAIAgentUserPolicyEntity, MJUserRoutineEntity, MJAIAgentRequestEntity } from '@memberjunction/core-entities';
+import { CompositeKey, type EntityInfo, type RunViewParams } from '@memberjunction/core';
+import { type AgentToolResult } from '../shared/agent-tool-validation';
+/**
+ * The cockpit serves one agent, identified by its metadata name. The id is resolved at runtime
+ * through `AIEngineBase.GetAgentByName`, never hardcoded.
+ */
+export declare const CHIEF_OF_STAFF_AGENT_NAME = "Chief of Staff";
+export type ChiefOfStaffTab = 'overview' | 'priorities' | 'approvals-wakes' | 'governance';
+export declare const VALID_CHIEF_OF_STAFF_TABS: readonly ChiefOfStaffTab[];
+export type TaskHealthStatus = 'OnTrack' | 'AtRisk' | 'OffTrack' | 'Completed' | 'Paused';
+export type HealthFilter = 'all' | TaskHealthStatus;
+export declare const VALID_HEALTH_FILTERS: readonly HealthFilter[];
+export type PolicyStatusValue = MJAIAgentUserPolicyEntity['Status'];
+export type PolicyCoordinationModeValue = MJAIAgentUserPolicyEntity['CoordinationMode'];
+export type PolicyDataAccessModeValue = MJAIAgentUserPolicyEntity['DefaultDataAccessMode'];
+export type PolicyEmailChannelModeValue = MJAIAgentUserPolicyEntity['EmailChannelMode'];
+export type PolicyCalendarChannelModeValue = MJAIAgentUserPolicyEntity['CalendarChannelMode'];
+export type PolicyPhoneChannelModeValue = MJAIAgentUserPolicyEntity['PhoneChannelMode'];
+export type PolicyMessagingChannelModeValue = MJAIAgentUserPolicyEntity['MessagingChannelMode'];
+export type RoutineStatusValue = MJUserRoutineEntity['Status'];
+export type RequestStatusValue = MJAIAgentRequestEntity['Status'];
+/**
+ * Projection shape for rows returned from `MJ_BizApps_Tasks: Tasks` (`[__mj_BizAppsTasks].[vwTasks]`).
+ */
+export interface BizAppsTaskRecordLike {
+    ID: string;
+    ParentID: string | null;
+    Name: string;
+    Description: string | null;
+    Status: string;
+    Priority: string | null;
+    IsPriority: boolean | number | null;
+    HealthStatus: TaskHealthStatus | null;
+    ConfidenceScore: number | null;
+    PercentComplete: number | null;
+    CheckInCadence: string | null;
+    PlanningPeriod: string | null;
+    BaselineValue: number | null;
+    TargetValue: number | null;
+    CurrentValue: number | null;
+    UnitOfMeasure: string | null;
+    MetricDirection: string | null;
+    DueAt: Date | string | null;
+    LastCheckInAt: Date | string | null;
+    NextCheckInDueAt: Date | string | null;
+    TypeID?: string | null;
+    Type?: string | null;
+    TaskType?: string | null;
+}
+/**
+ * Grouped priority objective card with its child milestones/tasks and computed progress.
+ */
+export interface PriorityObjectiveCardViewModel {
+    Task: BizAppsTaskRecordLike;
+    Subtasks: BizAppsTaskRecordLike[];
+    CompletedSubtaskCount: number;
+    EffectivePercentComplete: number;
+    EffectiveHealth: TaskHealthStatus;
+    MetricProgressLabel: string | null;
+    IsOverdue: boolean;
+}
+export interface RoutineSummaryItem {
+    ID: string;
+    Name: string;
+    Status: RoutineStatusValue;
+    ScheduleMode: MJUserRoutineEntity['ScheduleMode'];
+    CronExpression: string | null;
+    NextRunAt: Date | string | null;
+    LastRunAt: Date | string | null;
+    LastRunStatus: MJUserRoutineEntity['LastRunStatus'];
+}
+export interface RequestSummaryItem {
+    ID: string;
+    Request: string;
+    Status: RequestStatusValue;
+    Priority: number;
+    RequestedAt: Date | string;
+    ExpiresAt: Date | string | null;
+    RequestType?: MJAIAgentRequestEntity['RequestType'];
+    RequestTypeID?: MJAIAgentRequestEntity['RequestTypeID'];
+}
+export interface PolicyGovernanceSummary {
+    HasPolicyRecord: boolean;
+    DisplayName: string;
+    Status: PolicyStatusValue;
+    OnboardingStatus: MJAIAgentUserPolicyEntity['OnboardingStatus'];
+    CoordinationMode: PolicyCoordinationModeValue;
+    DefaultDataAccessMode: PolicyDataAccessModeValue;
+    EmailChannelMode: PolicyEmailChannelModeValue;
+    CalendarChannelMode: PolicyCalendarChannelModeValue;
+    PhoneChannelMode: PolicyPhoneChannelModeValue;
+    MessagingChannelMode: PolicyMessagingChannelModeValue;
+    AllowInterAgentCoordination: boolean;
+    RequireApprovalForExternalComms: boolean;
+    RequireApprovalForFinancials: boolean;
+    RequireApprovalForDestructiveActions: boolean;
+    AutoApproveAmountThreshold: number | null;
+}
+export interface ChiefOfStaffMetrics {
+    TotalTaskCount: number;
+    PriorityObjectiveCount: number;
+    SubtaskCount: number;
+    OnTrackCount: number;
+    AtRiskCount: number;
+    OffTrackCount: number;
+    CompletedPriorityCount: number;
+    AverageConfidenceScore: number | null;
+    AveragePriorityProgress: number;
+    PendingApprovalCount: number;
+    HighPriorityPendingCount: number;
+    ActiveWakeRoutineCount: number;
+    NextScheduledWakeAt: Date | null;
+    PriorityCards: PriorityObjectiveCardViewModel[];
+}
+export interface ChiefOfStaffAgentContextInput {
+    ActiveTab: ChiefOfStaffTab;
+    SearchText: string;
+    HealthFilter: HealthFilter;
+    Metrics: ChiefOfStaffMetrics;
+    Governance: PolicyGovernanceSummary;
+    Routines: readonly RoutineSummaryItem[];
+    PendingRequests: readonly RequestSummaryItem[];
+}
+export type AgentContextScalar = string | number | boolean | null;
+export type AgentContextRecord = Record<string, AgentContextScalar | string[] | Record<string, AgentContextScalar>>;
+/**
+ * Returns `true` when an `MJ: AI Agent Requests` row represents an actionable approval or
+ * review request for the Executive Cockpit's Pending Approvals queue, and `false` when it
+ * is a conversational `Information` turn created by `BaseAgent` when ending a chat turn.
+ */
+export declare function IsApprovalRequest(req: {
+    RequestType?: MJAIAgentRequestEntity['RequestType'] | undefined;
+    RequestTypeID?: MJAIAgentRequestEntity['RequestTypeID'] | undefined;
+}): boolean;
+export declare function ParseOptionalDate(val: Date | string | null | undefined): Date | null;
+/**
+ * Builds the primary key of a BizApps task from the entity's own primary key column(s) and the
+ * in-memory row. Tasks is an OpenApp entity, so neither the column name nor the column count is
+ * assumed; the same key feeds `OpenEntityRecord` and the `PrimaryKey` parameter of `Update Record`.
+ */
+export declare function BuildTaskRecordKey(entityInfo: EntityInfo, task: BizAppsTaskRecordLike): CompositeKey;
+export declare function IsTaskPriorityObjective(task: BizAppsTaskRecordLike): boolean;
+export declare function NormalizeTaskHealth(task: BizAppsTaskRecordLike): TaskHealthStatus;
+/**
+ * Percent progress from `BaselineValue` toward `TargetValue`, clamped to 0-100.
+ * Honors `MetricDirection` implicitly: a Down target (target < baseline) measures reduction.
+ * Returns null when there is no target or the target equals the baseline (no measurable span).
+ */
+export declare function ComputeTaskMetricPercent(task: BizAppsTaskRecordLike): number | null;
+/** ExtraFilters for the cockpit's three core-entity queries. Every clause is bound to the current user: the cockpit never shows another user's Chief of Staff data. */
+export interface CockpitScopeFilters {
+    Policy: string;
+    Routines: string;
+    Requests: string;
+}
+export declare function BuildCockpitScopeFilters(currentUserId: string, chiefOfStaffAgentId: string): CockpitScopeFilters;
+/** OpenApp entity holding the person linked to the signed-in MJ user (`LinkedUserID`). */
+export declare const BIZAPPS_PEOPLE_ENTITY_NAME = "MJ_BizApps_Common: People";
+/** OpenApp entity linking tasks to the people assigned to them. */
+export declare const BIZAPPS_TASK_ASSIGNMENTS_ENTITY_NAME = "MJ_BizApps_Tasks: Task Assignments";
+/** CSS modifier for a task priority badge, keyed by the Tasks `Priority` value list (Critical/High/Medium/Low). */
+export declare function GetTaskPriorityClass(priority: string | null): string;
+/** Minimal RunView surface the task-scope resolver needs; `RunView` from @memberjunction/core satisfies it. */
+export interface TaskScopeQueryRunner {
+    RunView<T>(params: RunViewParams): Promise<{
+        Success: boolean;
+        Results: T[];
+        ErrorMessage?: string;
+    }>;
+}
+export type PersonTaskScope = {
+    HasLinkedPerson: false;
+} | {
+    HasLinkedPerson: true;
+    PersonID: string;
+    Filter: string;
+};
+/**
+ * Resolve the BizApps person linked to `currentUserId` and the filter that limits the Tasks query to work
+ * that person created or is assigned to. Throws when either lookup fails so the caller can show the error.
+ */
+export declare function ResolvePersonTaskScope(runner: TaskScopeQueryRunner, currentUserId: string): Promise<PersonTaskScope>;
+/**
+ * ExtraFilter for `MJ_BizApps_Tasks: Tasks` limiting rows to work the given person created or is assigned to.
+ * `assignedTaskIDs` come from `MJ_BizApps_Tasks: Task Assignments` for the same person.
+ */
+export declare function BuildPersonScopedTaskFilter(personID: string, assignedTaskIDs: readonly string[]): string;
+export declare function FormatTaskMetricProgress(task: BizAppsTaskRecordLike): string | null;
+export declare function CalculateChiefOfStaffMetrics(tasks: readonly BizAppsTaskRecordLike[], routines: readonly RoutineSummaryItem[], requests: readonly RequestSummaryItem[], now?: Date): ChiefOfStaffMetrics;
+export declare function BuildChiefOfStaffAgentContext(input: ChiefOfStaffAgentContextInput): AgentContextRecord;
+export declare function ValidateChiefOfStaffTabParam(raw: string | number | boolean | null | undefined): {
+    ok: true;
+    value: ChiefOfStaffTab;
+} | {
+    ok: false;
+    result: AgentToolResult;
+};
+export declare function ValidateHealthFilterParam(raw: string | number | boolean | null | undefined): {
+    ok: true;
+    value: HealthFilter;
+} | {
+    ok: false;
+    result: AgentToolResult;
+};
+export declare function ValidateSearchQueryParam(raw: string | number | boolean | null | undefined): {
+    ok: true;
+    value: string;
+} | {
+    ok: false;
+    result: AgentToolResult;
+};
+export declare function ResolvePriorityObjectiveByIDOrName(cards: readonly PriorityObjectiveCardViewModel[], rawRef: string | number | boolean | null | undefined): {
+    ok: true;
+    value: PriorityObjectiveCardViewModel;
+} | {
+    ok: false;
+    error: string;
+};
+//# sourceMappingURL=chief-of-staff-agent-context.d.ts.map

package/dist/ChiefOfStaff/chief-of-staff-agent-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chief-of-staff-agent-context.d.ts","sourceRoot":"","sources":["../../src/ChiefOfStaff/chief-of-staff-agent-context.ts"],"names":[],"mappings":"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"}