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

package/dist/ChiefOfStaff/chief-of-staff-agent-context.js

@@ -1,248 +1,235 @@
 /**
- * Pure, unit-testable helpers for the "My Chief of Staff" Executive Cockpit's
- * agent context + client tools.
+ * Pure, unit-testable helpers for the Chief of Staff application's pages (Overview,
+ * Approvals & Wakes, Governance): their agent context, client tools and policy drafts.
+ *
+ * Core only: everything here reads core entities (`MJ: AI Agent User Policies`,
+ * `MJ: User Routines`, `MJ: AI Agent Requests`). Business data such as priorities, tasks and
+ * to-dos comes from Open Apps that add their own nav items to the Chief of Staff application
+ * through `NavItem.*` application settings; core never names an Open App's entities.
  *
  * 🚨 SAFETY BOUNDARY 🚨
- * The Chief of Staff Cockpit exposes ONLY navigation / tab-switch / filter / search /
+ * The Chief of Staff pages expose ONLY navigation / 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
+ * Published context exposes only aggregate counts, the current page and search, governance
  * mode summaries, and bounded display names (capped at 25) — never raw request payloads,
  * custom instructions overrides, or private message content.
  */
-import { CompositeKey } from '@memberjunction/core';
-import { EscapeSQLString, GroupByUUID, UUIDsEqual } from '@memberjunction/global';
+import { EscapeSQLString } from '@memberjunction/global';
 import { AGENT_CONTEXT_NAME_LIST_CAP, BoundNameList, ValidateEnumParam, ValidateStringParam, } from '../shared/agent-tool-validation';
 /**
- * The cockpit serves one agent, identified by its metadata name. The id is resolved at runtime
+ * The pages serve one agent, identified by its metadata name. The id is resolved at runtime
  * through `AIEngineBase.GetAgentByName`, never hardcoded.
  */
 export const CHIEF_OF_STAFF_AGENT_NAME = 'Chief of Staff';
-export const VALID_CHIEF_OF_STAFF_TABS = [
+/** The name of the Chief of Staff application whose nav items open the pages. */
+export const CHIEF_OF_STAFF_APP_NAME = 'Chief of Staff';
+export const CHIEF_OF_STAFF_PAGES = [
     'overview',
-    'priorities',
     'approvals-wakes',
     'governance',
 ];
-export const VALID_HEALTH_FILTERS = [
-    'all',
-    'OnTrack',
-    'AtRisk',
-    'OffTrack',
-    'Completed',
-    'Paused',
-];
+/** Each page's nav item label; must match the application's `DefaultNavItems`. */
+export const CHIEF_OF_STAFF_PAGE_LABELS = {
+    overview: 'Overview',
+    'approvals-wakes': 'Approvals & Wakes',
+    governance: 'Governance',
+};
+/** Each page's Font Awesome icon; matches the application's `DefaultNavItems`. */
+export const CHIEF_OF_STAFF_PAGE_ICONS = {
+    overview: 'fa-solid fa-compass',
+    'approvals-wakes': 'fa-solid fa-bell-concierge',
+    governance: 'fa-solid fa-shield-halved',
+};
 /**
- * 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.
+ * True for a one-shot routine that has run and has no next time: the dispatcher disables a one-shot
+ * once it fires, so "Disabled" here means "done", not "broken". A one-shot still waiting for its
+ * time is not spent, whatever it has run before (a manual run keeps the schedule); a one-shot that
+ * was disabled before ever running is just disabled; a recurring routine is never spent.
  */
-export function IsApprovalRequest(req) {
-    // The RequestType virtual field carries the type name; classify on it alone.
-    const typeName = req.RequestType?.trim().toLowerCase() ?? '';
-    return typeName !== 'information';
+export function IsSpentOneShotRoutine(routine) {
+    return routine.ScheduleMode === 'OneShot'
+        && routine.Status === 'Disabled'
+        && routine.NextRunAt == null
+        && routine.LastRunAt != null;
 }
-export function ParseOptionalDate(val) {
-    if (!val) {
-        return null;
-    }
-    if (val instanceof Date) {
-        return isNaN(val.getTime()) ? null : val;
-    }
-    const parsed = new Date(val);
-    return isNaN(parsed.getTime()) ? null : parsed;
+/** 'Fired' for a spent one-shot, otherwise the routine's own Status. */
+export function RoutineDisplayStatus(routine) {
+    return IsSpentOneShotRoutine(routine) ? 'Fired' : routine.Status;
 }
 /**
- * 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`.
+ * Display order for the wake schedule: routines with a next wake first, soonest first; then the
+ * unscheduled (paused, or disabled before ever running); spent one-shots last, most recent first.
+ * Returns a new array.
  */
-export function BuildTaskRecordKey(entityInfo, task) {
-    return CompositeKey.FromEntityRecord(entityInfo, { ...task });
+export function SortRoutinesForDisplay(routines) {
+    const rank = (r) => (IsSpentOneShotRoutine(r) ? 2 : r.NextRunAt != null ? 0 : 1);
+    const time = (value) => {
+        const parsed = ParseOptionalDate(value);
+        return parsed ? parsed.getTime() : Number.POSITIVE_INFINITY;
+    };
+    return [...routines].sort((a, b) => {
+        const ra = rank(a);
+        const rb = rank(b);
+        if (ra !== rb)
+            return ra - rb;
+        if (ra === 0)
+            return time(a.NextRunAt) - time(b.NextRunAt);
+        if (ra === 2)
+            return time(b.LastRunAt) - time(a.LastRunAt);
+        return 0;
+    });
 }
-export function IsTaskPriorityObjective(task) {
-    if (task.IsPriority === true || task.IsPriority === 1) {
-        return true;
-    }
-    const typeLabel = (task.Type ?? task.TaskType ?? '').toLowerCase();
-    if (typeLabel.includes('priority') ||
-        typeLabel.includes('objective') ||
-        typeLabel.includes('okr')) {
-        return true;
+/**
+ * Reads the email draft out of an approval request's Comments. Returns null when the comments are
+ * empty, not JSON, or not an email (a call brief, say), so callers can show the draft only when
+ * there is one. An older payload without `Operation` counts as a `Send` when To and Subject exist.
+ */
+export function ParseEmailApprovalPayload(comments) {
+    const text = comments?.trim();
+    if (!text || !text.startsWith('{')) {
+        return null;
     }
-    return task.ParentID == null && (task.HealthStatus != null || task.PlanningPeriod != null);
-}
-export function NormalizeTaskHealth(task) {
-    if (task.Status === 'Completed' || task.Status === 'Done' || task.HealthStatus === 'Completed') {
-        return 'Completed';
+    let raw;
+    try {
+        raw = JSON.parse(text);
     }
-    if (task.HealthStatus === 'AtRisk' || task.HealthStatus === 'OffTrack' || task.HealthStatus === 'Paused') {
-        return task.HealthStatus;
+    catch {
+        return null;
     }
-    return 'OnTrack';
-}
-/**
- * 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 function ComputeTaskMetricPercent(task) {
-    if (task.TargetValue == null) {
+    if (!raw || typeof raw !== 'object') {
         return null;
     }
-    const baseline = task.BaselineValue ?? 0;
-    const span = task.TargetValue - baseline;
-    if (span === 0) {
+    const record = raw;
+    const to = stringField(record, 'To');
+    const subject = stringField(record, 'Subject');
+    const body = stringField(record, 'Body');
+    if (to == null || subject == null || body == null) {
         return null;
     }
-    const current = task.CurrentValue ?? baseline;
-    const raw = ((current - baseline) / span) * 100;
-    return Math.max(0, Math.min(100, Math.round(raw)));
+    const operation = stringField(record, 'Operation');
+    const op = operation === 'Reply' || operation === 'Forward' ? operation : 'Send';
+    const cc = Array.isArray(record['CCRecipients'])
+        ? record['CCRecipients'].filter((c) => typeof c === 'string' && c.trim().length > 0)
+        : [];
+    return { Operation: op, From: stringField(record, 'From'), To: to, CC: cc, Subject: subject, Body: body };
 }
-export function BuildCockpitScopeFilters(currentUserId, chiefOfStaffAgentId) {
-    const user = EscapeSQLString(currentUserId);
-    const agent = EscapeSQLString(chiefOfStaffAgentId);
+/** The draft as plain text for a mail client: headers, a blank line, then the body. */
+export function FormatEmailDraftForClipboard(draft) {
+    const lines = [`To: ${draft.To}`];
+    if (draft.CC.length > 0) {
+        lines.push(`CC: ${draft.CC.join(', ')}`);
+    }
+    lines.push(`Subject: ${draft.Subject}`, '', draft.Body);
+    return lines.join('\n');
+}
+function stringField(record, key) {
+    const value = record[key];
+    return typeof value === 'string' ? value : null;
+}
+/** The draft shown before the user has a policy record. */
+export function CreateDefaultPolicyDraft() {
     return {
-        Policy: `AgentID = '${agent}' AND UserID = '${user}'`,
-        Routines: `UserID = '${user}' AND (RoutineType = 'AgentWake' OR TargetID = '${agent}')`,
-        Requests: `AgentID = '${agent}' AND RequestForUserID = '${user}' AND (RequestType IS NULL OR RequestType <> 'Information')`,
+        DisplayNameOverride: 'Chief of Staff',
+        Status: 'Active',
+        OnboardingStatus: 'Completed',
+        CoordinationMode: 'Coordinator',
+        DefaultDataAccessMode: 'UserCeiling',
+        EmailChannelMode: 'DraftOnly',
+        CalendarChannelMode: 'ProposeWithApproval',
+        PhoneChannelMode: 'Disabled',
+        MessagingChannelMode: 'Enabled',
+        AllowInterAgentCoordination: true,
+        RequireApprovalForExternalComms: true,
+        RequireApprovalForFinancials: true,
+        RequireApprovalForDestructiveActions: true,
+        AutoApproveAmountThreshold: 0,
+        InstructionsOverride: '',
     };
 }
-/** OpenApp entity holding the person linked to the signed-in MJ user (`LinkedUserID`). */
-export const BIZAPPS_PEOPLE_ENTITY_NAME = 'MJ_BizApps_Common: People';
-/** OpenApp entity linking tasks to the people assigned to them. */
-export 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 function GetTaskPriorityClass(priority) {
-    switch ((priority ?? '').toLowerCase()) {
-        case 'critical':
-            return 'priority-critical';
-        case 'high':
-            return 'priority-high';
-        case 'low':
-            return 'priority-low';
-        default:
-            return 'priority-normal';
+/** A draft copied from the user's policy record, or the default draft when there is none. */
+export function BuildPolicyDraftFromEntity(entity) {
+    if (!entity) {
+        return CreateDefaultPolicyDraft();
     }
+    return {
+        DisplayNameOverride: entity.DisplayNameOverride ?? '',
+        Status: entity.Status,
+        OnboardingStatus: entity.OnboardingStatus,
+        CoordinationMode: entity.CoordinationMode,
+        DefaultDataAccessMode: entity.DefaultDataAccessMode,
+        EmailChannelMode: entity.EmailChannelMode,
+        CalendarChannelMode: entity.CalendarChannelMode,
+        PhoneChannelMode: entity.PhoneChannelMode,
+        MessagingChannelMode: entity.MessagingChannelMode,
+        AllowInterAgentCoordination: entity.AllowInterAgentCoordination,
+        RequireApprovalForExternalComms: entity.RequireApprovalForExternalComms,
+        RequireApprovalForFinancials: entity.RequireApprovalForFinancials,
+        RequireApprovalForDestructiveActions: entity.RequireApprovalForDestructiveActions,
+        AutoApproveAmountThreshold: entity.AutoApproveAmountThreshold,
+        InstructionsOverride: entity.InstructionsOverride ?? '',
+    };
 }
-/**
- * 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 async function ResolvePersonTaskScope(runner, currentUserId) {
-    const people = await runner.RunView({
-        EntityName: BIZAPPS_PEOPLE_ENTITY_NAME,
-        ExtraFilter: `LinkedUserID = '${EscapeSQLString(currentUserId)}'`,
-        Fields: ['ID'],
-        MaxRows: 1,
-        ResultType: 'simple',
-    });
-    if (!people.Success) {
-        throw new Error(people.ErrorMessage ?? 'Failed to resolve the linked person.');
-    }
-    const personID = people.Results[0]?.ID;
-    if (!personID) {
-        return { HasLinkedPerson: false };
-    }
-    const assignments = await runner.RunView({
-        EntityName: BIZAPPS_TASK_ASSIGNMENTS_ENTITY_NAME,
-        ExtraFilter: `PersonID = '${EscapeSQLString(personID)}'`,
-        Fields: ['TaskID'],
-        ResultType: 'simple',
-    });
-    if (!assignments.Success) {
-        throw new Error(assignments.ErrorMessage ?? 'Failed to load task assignments.');
-    }
-    const assignedTaskIDs = assignments.Results.map((a) => a.TaskID).filter((id) => !!id);
-    return { HasLinkedPerson: true, PersonID: personID, Filter: BuildPersonScopedTaskFilter(personID, assignedTaskIDs) };
+/** The display name: the draft's override, or 'My Chief of Staff'. */
+export function ChiefOfStaffDisplayName(draft) {
+    const override = draft.DisplayNameOverride.trim();
+    return override.length > 0 ? override : 'My Chief of Staff';
+}
+/** The governance summary published in the agent context. */
+export function BuildGovernanceSummary(draft, hasPolicyRecord) {
+    return {
+        HasPolicyRecord: hasPolicyRecord,
+        DisplayName: ChiefOfStaffDisplayName(draft),
+        Status: draft.Status,
+        OnboardingStatus: draft.OnboardingStatus,
+        CoordinationMode: draft.CoordinationMode,
+        DefaultDataAccessMode: draft.DefaultDataAccessMode,
+        EmailChannelMode: draft.EmailChannelMode,
+        CalendarChannelMode: draft.CalendarChannelMode,
+        PhoneChannelMode: draft.PhoneChannelMode,
+        MessagingChannelMode: draft.MessagingChannelMode,
+        AllowInterAgentCoordination: draft.AllowInterAgentCoordination,
+        RequireApprovalForExternalComms: draft.RequireApprovalForExternalComms,
+        RequireApprovalForFinancials: draft.RequireApprovalForFinancials,
+        RequireApprovalForDestructiveActions: draft.RequireApprovalForDestructiveActions,
+        AutoApproveAmountThreshold: draft.AutoApproveAmountThreshold,
+    };
 }
 /**
- * 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.
+ * Returns `true` when an `MJ: AI Agent Requests` row represents an actionable approval or
+ * review request for the Chief of Staff's Pending Approvals queue, and `false` when it
+ * is a conversational `Information` turn created by `BaseAgent` when ending a chat turn.
  */
-export function BuildPersonScopedTaskFilter(personID, assignedTaskIDs) {
-    const createdClause = `CreatedByPersonID = '${EscapeSQLString(personID)}'`;
-    if (assignedTaskIDs.length === 0) {
-        return createdClause;
-    }
-    const idList = assignedTaskIDs.map((id) => `'${EscapeSQLString(id)}'`).join(', ');
-    return `${createdClause} OR ID IN (${idList})`;
+export function IsApprovalRequest(req) {
+    // The RequestType virtual field carries the type name; classify on it alone.
+    const typeName = req.RequestType?.trim().toLowerCase() ?? '';
+    return typeName !== 'information';
 }
-export function FormatTaskMetricProgress(task) {
-    if (task.TargetValue == null && task.CurrentValue == null) {
+export function ParseOptionalDate(val) {
+    if (!val) {
         return null;
     }
-    const unit = task.UnitOfMeasure ? ` ${task.UnitOfMeasure}` : '';
-    const current = task.CurrentValue ?? task.BaselineValue ?? 0;
-    if (task.TargetValue != null) {
-        return `${current}${unit} / ${task.TargetValue}${unit}`;
+    if (val instanceof Date) {
+        return isNaN(val.getTime()) ? null : val;
     }
-    return `${current}${unit}`;
+    const parsed = new Date(val);
+    return isNaN(parsed.getTime()) ? null : parsed;
 }
-export function CalculateChiefOfStaffMetrics(tasks, routines, requests, now = new Date()) {
-    const subtasksByParent = GroupByUUID(tasks.filter((t) => !!t.ParentID), (t) => t.ParentID);
-    const priorityTasks = [];
-    for (const task of tasks) {
-        const hasChildren = subtasksByParent.Has(task.ID);
-        if (!task.ParentID && (IsTaskPriorityObjective(task) || hasChildren)) {
-            priorityTasks.push(task);
-        }
-    }
-    // Only qualifying objectives are shown; an empty list renders the tab's empty state rather than unrelated root tasks.
-    const rootsToDisplay = priorityTasks;
-    let onTrackCount = 0;
-    let atRiskCount = 0;
-    let offTrackCount = 0;
-    let completedPriorityCount = 0;
-    let confidenceSum = 0;
-    let confidenceCount = 0;
-    let progressSum = 0;
-    const priorityCards = rootsToDisplay.map((root) => {
-        const children = subtasksByParent.Get(root.ID) ?? [];
-        const completedChildren = children.filter((c) => c.Status === 'Completed' || c.Status === 'Done' || (c.PercentComplete ?? 0) >= 100).length;
-        const metricPercent = ComputeTaskMetricPercent(root);
-        const rawPercent = metricPercent !== null
-            ? metricPercent
-            : typeof root.PercentComplete === 'number' && root.PercentComplete > 0
-                ? root.PercentComplete
-                : children.length > 0
-                    ? Math.round((completedChildren / children.length) * 100)
-                    : root.Status === 'Completed' || root.Status === 'Done'
-                        ? 100
-                        : 0;
-        const effectivePercent = Math.max(0, Math.min(100, rawPercent));
-        const effectiveHealth = NormalizeTaskHealth(root);
-        if (effectiveHealth === 'OnTrack')
-            onTrackCount++;
-        else if (effectiveHealth === 'AtRisk')
-            atRiskCount++;
-        else if (effectiveHealth === 'OffTrack')
-            offTrackCount++;
-        else if (effectiveHealth === 'Completed')
-            completedPriorityCount++;
-        if (typeof root.ConfidenceScore === 'number' && Number.isFinite(root.ConfidenceScore)) {
-            confidenceSum += root.ConfidenceScore;
-            confidenceCount++;
-        }
-        progressSum += effectivePercent;
-        const dueDate = ParseOptionalDate(root.DueAt);
-        const isOverdue = dueDate !== null &&
-            dueDate.getTime() < now.getTime() &&
-            effectiveHealth !== 'Completed';
-        return {
-            Task: root,
-            Subtasks: children,
-            CompletedSubtaskCount: completedChildren,
-            EffectivePercentComplete: effectivePercent,
-            EffectiveHealth: effectiveHealth,
-            MetricProgressLabel: FormatTaskMetricProgress(root),
-            IsOverdue: isOverdue,
-        };
-    });
+export function BuildChiefOfStaffScopeFilters(currentUserId, chiefOfStaffAgentId) {
+    const user = EscapeSQLString(currentUserId);
+    const agent = EscapeSQLString(chiefOfStaffAgentId);
+    return {
+        Policy: `AgentID = '${agent}' AND UserID = '${user}'`,
+        Routines: `UserID = '${user}' AND (RoutineType = 'AgentWake' OR TargetID = '${agent}')`,
+        Requests: `AgentID = '${agent}' AND RequestForUserID = '${user}' AND (RequestType IS NULL OR RequestType <> 'Information')`,
+    };
+}
+/** The core counts: pending approvals and active wakes. */
+export function CalculateChiefOfStaffMetrics(routines, requests) {
     const pendingRequests = requests.filter((r) => r.Status === 'Requested' && IsApprovalRequest(r));
     const highPriorityPending = pendingRequests.filter((r) => r.Priority >= 51);
     const activeWakeRoutines = routines.filter((r) => r.Status === 'Active');
@@ -253,41 +240,20 @@ export function CalculateChiefOfStaffMetrics(tasks, routines, requests, now = ne
             nextScheduledWakeAt = nextRun;
         }
     }
-    const totalSubtasks = tasks.filter((t) => !!t.ParentID).length;
     return {
-        TotalTaskCount: tasks.length,
-        PriorityObjectiveCount: priorityCards.length,
-        SubtaskCount: totalSubtasks,
-        OnTrackCount: onTrackCount,
-        AtRiskCount: atRiskCount,
-        OffTrackCount: offTrackCount,
-        CompletedPriorityCount: completedPriorityCount,
-        AverageConfidenceScore: confidenceCount > 0 ? Math.round((confidenceSum / confidenceCount) * 10) / 10 : null,
-        AveragePriorityProgress: priorityCards.length > 0 ? Math.round(progressSum / priorityCards.length) : 0,
         PendingApprovalCount: pendingRequests.length,
         HighPriorityPendingCount: highPriorityPending.length,
         ActiveWakeRoutineCount: activeWakeRoutines.length,
         NextScheduledWakeAt: nextScheduledWakeAt,
-        PriorityCards: priorityCards,
     };
 }
 export function BuildChiefOfStaffAgentContext(input) {
-    const priorityNames = input.Metrics.PriorityCards.map((c) => c.Task.Name).filter((n) => !!n);
-    const boundedPriorityNames = BoundNameList(priorityNames, AGENT_CONTEXT_NAME_LIST_CAP);
     const routineNames = input.Routines.map((r) => `${r.Name} (${r.Status})`).filter((n) => !!n);
     const boundedRoutineNames = BoundNameList(routineNames, AGENT_CONTEXT_NAME_LIST_CAP);
-    const context = {
-        Surface: 'ChiefOfStaffDashboard',
-        ActiveTab: input.ActiveTab,
+    return {
+        Surface: 'ChiefOfStaff',
+        Page: input.Page,
         SearchText: input.SearchText,
-        HealthFilter: input.HealthFilter,
-        PriorityObjectiveCount: input.Metrics.PriorityObjectiveCount,
-        SubtaskCount: input.Metrics.SubtaskCount,
-        OnTrackCount: input.Metrics.OnTrackCount,
-        AtRiskCount: input.Metrics.AtRiskCount,
-        OffTrackCount: input.Metrics.OffTrackCount,
-        CompletedPriorityCount: input.Metrics.CompletedPriorityCount,
-        AveragePriorityProgressPercent: input.Metrics.AveragePriorityProgress,
         PendingApprovalCount: input.Metrics.PendingApprovalCount,
         HighPriorityPendingCount: input.Metrics.HighPriorityPendingCount,
         ActiveWakeRoutineCount: input.Metrics.ActiveWakeRoutineCount,
@@ -310,65 +276,14 @@ export function BuildChiefOfStaffAgentContext(input) {
             RequireApprovalForDestructiveActions: input.Governance.RequireApprovalForDestructiveActions,
             AutoApproveAmountThreshold: input.Governance.AutoApproveAmountThreshold,
         },
-        VisiblePriorityObjectiveNames: boundedPriorityNames,
         VisibleWakeRoutineNames: boundedRoutineNames,
     };
-    if (priorityNames.length > boundedPriorityNames.length) {
-        context['VisiblePriorityObjectiveNamesTruncated'] = true;
-        context['VisiblePriorityObjectiveNamesTotal'] = priorityNames.length;
-    }
-    return context;
-}
-export function ValidateChiefOfStaffTabParam(raw) {
-    return ValidateEnumParam(raw, VALID_CHIEF_OF_STAFF_TABS, 'tab');
 }
-export function ValidateHealthFilterParam(raw) {
-    return ValidateEnumParam(raw, VALID_HEALTH_FILTERS, 'health');
+/** Validates a page parameter against the Chief of Staff application's own pages. */
+export function ValidateChiefOfStaffPageParam(raw) {
+    return ValidateEnumParam(raw, CHIEF_OF_STAFF_PAGES, 'page');
 }
 export function ValidateSearchQueryParam(raw) {
     return ValidateStringParam(raw, 'query');
 }
-export function ResolvePriorityObjectiveByIDOrName(cards, rawRef) {
-    if (typeof rawRef !== 'string' || rawRef.trim().length === 0) {
-        return {
-            ok: false,
-            error: `Provide a priority objective ID or name. ${availableObjectiveNames(cards)}`,
-        };
-    }
-    const ref = rawRef.trim();
-    const byId = cards.find((c) => UUIDsEqual(c.Task.ID, ref));
-    if (byId) {
-        return { ok: true, value: byId };
-    }
-    const byName = cards.find((c) => c.Task.Name.trim().toLowerCase() === ref.toLowerCase());
-    if (byName) {
-        return { ok: true, value: byName };
-    }
-    const partial = cards.filter((c) => c.Task.Name.toLowerCase().includes(ref.toLowerCase()));
-    if (partial.length === 1) {
-        return { ok: true, value: partial[0] };
-    }
-    if (partial.length > 1) {
-        const names = partial
-            .slice(0, AGENT_CONTEXT_NAME_LIST_CAP)
-            .map((c) => c.Task.Name)
-            .join(', ');
-        return {
-            ok: false,
-            error: `'${ref}' matches multiple priority objectives: ${names}. Be more specific.`,
-        };
-    }
-    return {
-        ok: false,
-        error: `No priority objective matches '${ref}'. ${availableObjectiveNames(cards)}`,
-    };
-}
-function availableObjectiveNames(cards) {
-    if (cards.length === 0) {
-        return 'There are no priority objectives loaded.';
-    }
-    const names = cards.slice(0, AGENT_CONTEXT_NAME_LIST_CAP).map((c) => c.Task.Name);
-    const suffix = cards.length > AGENT_CONTEXT_NAME_LIST_CAP ? ', …' : '';
-    return `Available priority objectives: ${names.join(', ')}${suffix}`;
-}
 //# sourceMappingURL=chief-of-staff-agent-context.js.map