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

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

@@ -0,0 +1,198 @@
+/**
+ * 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 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, 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 type { MJAIAgentUserPolicyEntity, MJUserRoutineEntity, MJAIAgentRequestEntity } from '@memberjunction/core-entities';
+import { type AgentToolResult } from '../shared/agent-tool-validation';
+/**
+ * The pages serve 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";
+/** The name of the Chief of Staff application whose nav items open the pages. */
+export declare const CHIEF_OF_STAFF_APP_NAME = "Chief of Staff";
+/** The Chief of Staff application's own pages; each is one nav item. */
+export type ChiefOfStaffPage = 'overview' | 'approvals-wakes' | 'governance';
+export declare const CHIEF_OF_STAFF_PAGES: readonly ChiefOfStaffPage[];
+/** Each page's nav item label; must match the application's `DefaultNavItems`. */
+export declare const CHIEF_OF_STAFF_PAGE_LABELS: Readonly<Record<ChiefOfStaffPage, string>>;
+/** Each page's Font Awesome icon; matches the application's `DefaultNavItems`. */
+export declare const CHIEF_OF_STAFF_PAGE_ICONS: Readonly<Record<ChiefOfStaffPage, string>>;
+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'];
+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'];
+}
+/** The status label the pages show for a routine: the entity's Status, or 'Fired' for a spent one-shot. */
+export type RoutineDisplayStatusValue = RoutineSummaryItem['Status'] | 'Fired';
+/**
+ * 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 declare function IsSpentOneShotRoutine(routine: Pick<RoutineSummaryItem, 'ScheduleMode' | 'NextRunAt' | 'LastRunAt' | 'Status'>): boolean;
+/** 'Fired' for a spent one-shot, otherwise the routine's own Status. */
+export declare function RoutineDisplayStatus(routine: Pick<RoutineSummaryItem, 'ScheduleMode' | 'NextRunAt' | 'LastRunAt' | 'Status'>): RoutineDisplayStatusValue;
+/**
+ * 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 declare function SortRoutinesForDisplay<T extends Pick<RoutineSummaryItem, 'ScheduleMode' | 'NextRunAt' | 'LastRunAt' | 'Status'>>(routines: readonly T[]): T[];
+/**
+ * An outbound email waiting for approval, as the email action records it in the request's
+ * `Comments` (JSON with Operation / From / To / CCRecipients / Subject / Body).
+ */
+export interface EmailApprovalDraft {
+    Operation: 'Send' | 'Reply' | 'Forward';
+    From: string | null;
+    To: string;
+    CC: string[];
+    Subject: string;
+    Body: string;
+}
+/**
+ * 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 declare function ParseEmailApprovalPayload(comments: string | null | undefined): EmailApprovalDraft | null;
+/** The draft as plain text for a mail client: headers, a blank line, then the body. */
+export declare function FormatEmailDraftForClipboard(draft: EmailApprovalDraft): string;
+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;
+}
+/** The Governance page's editable copy of the user's policy. */
+export interface GovernancePolicyDraft {
+    DisplayNameOverride: 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;
+    InstructionsOverride: string;
+}
+/** The draft shown before the user has a policy record. */
+export declare function CreateDefaultPolicyDraft(): GovernancePolicyDraft;
+/** A draft copied from the user's policy record, or the default draft when there is none. */
+export declare function BuildPolicyDraftFromEntity(entity: MJAIAgentUserPolicyEntity | null): GovernancePolicyDraft;
+/** The display name: the draft's override, or 'My Chief of Staff'. */
+export declare function ChiefOfStaffDisplayName(draft: Pick<GovernancePolicyDraft, 'DisplayNameOverride'>): string;
+/** The governance summary published in the agent context. */
+export declare function BuildGovernanceSummary(draft: GovernancePolicyDraft, hasPolicyRecord: boolean): PolicyGovernanceSummary;
+export interface ChiefOfStaffMetrics {
+    PendingApprovalCount: number;
+    HighPriorityPendingCount: number;
+    ActiveWakeRoutineCount: number;
+    NextScheduledWakeAt: Date | null;
+}
+export interface ChiefOfStaffAgentContextInput {
+    Page: ChiefOfStaffPage;
+    SearchText: string;
+    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 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 declare function IsApprovalRequest(req: {
+    RequestType?: MJAIAgentRequestEntity['RequestType'] | undefined;
+    RequestTypeID?: MJAIAgentRequestEntity['RequestTypeID'] | undefined;
+}): boolean;
+export declare function ParseOptionalDate(val: Date | string | null | undefined): Date | null;
+/** ExtraFilters for the pages' three core-entity queries. Every clause is bound to the current user: the pages never show another user's Chief of Staff data. */
+export interface ChiefOfStaffScopeFilters {
+    Policy: string;
+    Routines: string;
+    Requests: string;
+}
+export declare function BuildChiefOfStaffScopeFilters(currentUserId: string, chiefOfStaffAgentId: string): ChiefOfStaffScopeFilters;
+/** The core counts: pending approvals and active wakes. */
+export declare function CalculateChiefOfStaffMetrics(routines: readonly RoutineSummaryItem[], requests: readonly RequestSummaryItem[]): ChiefOfStaffMetrics;
+export declare function BuildChiefOfStaffAgentContext(input: ChiefOfStaffAgentContextInput): AgentContextRecord;
+/** Validates a page parameter against the Chief of Staff application's own pages. */
+export declare function ValidateChiefOfStaffPageParam(raw: string | number | boolean | null | undefined): {
+    ok: true;
+    value: ChiefOfStaffPage;
+} | {
+    ok: false;
+    result: AgentToolResult;
+};
+export declare function ValidateSearchQueryParam(raw: string | number | boolean | null | undefined): {
+    ok: true;
+    value: string;
+} | {
+    ok: false;
+    result: AgentToolResult;
+};
+//# 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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"}

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

@@ -0,0 +1,289 @@
+/**
+ * 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 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, 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 { EscapeSQLString } from '@memberjunction/global';
+import { AGENT_CONTEXT_NAME_LIST_CAP, BoundNameList, ValidateEnumParam, ValidateStringParam, } from '../shared/agent-tool-validation';
+/**
+ * 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';
+/** 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',
+    'approvals-wakes',
+    'governance',
+];
+/** 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',
+};
+/**
+ * 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 IsSpentOneShotRoutine(routine) {
+    return routine.ScheduleMode === 'OneShot'
+        && routine.Status === 'Disabled'
+        && routine.NextRunAt == null
+        && routine.LastRunAt != null;
+}
+/** 'Fired' for a spent one-shot, otherwise the routine's own Status. */
+export function RoutineDisplayStatus(routine) {
+    return IsSpentOneShotRoutine(routine) ? 'Fired' : routine.Status;
+}
+/**
+ * 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 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;
+    });
+}
+/**
+ * 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;
+    }
+    let raw;
+    try {
+        raw = JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+    if (!raw || typeof raw !== 'object') {
+        return null;
+    }
+    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 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 };
+}
+/** 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 {
+        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: '',
+    };
+}
+/** 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 ?? '',
+    };
+}
+/** 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,
+    };
+}
+/**
+ * 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 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 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;
+}
+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');
+    let nextScheduledWakeAt = null;
+    for (const routine of activeWakeRoutines) {
+        const nextRun = ParseOptionalDate(routine.NextRunAt);
+        if (nextRun && (!nextScheduledWakeAt || nextRun.getTime() < nextScheduledWakeAt.getTime())) {
+            nextScheduledWakeAt = nextRun;
+        }
+    }
+    return {
+        PendingApprovalCount: pendingRequests.length,
+        HighPriorityPendingCount: highPriorityPending.length,
+        ActiveWakeRoutineCount: activeWakeRoutines.length,
+        NextScheduledWakeAt: nextScheduledWakeAt,
+    };
+}
+export function BuildChiefOfStaffAgentContext(input) {
+    const routineNames = input.Routines.map((r) => `${r.Name} (${r.Status})`).filter((n) => !!n);
+    const boundedRoutineNames = BoundNameList(routineNames, AGENT_CONTEXT_NAME_LIST_CAP);
+    return {
+        Surface: 'ChiefOfStaff',
+        Page: input.Page,
+        SearchText: input.SearchText,
+        PendingApprovalCount: input.Metrics.PendingApprovalCount,
+        HighPriorityPendingCount: input.Metrics.HighPriorityPendingCount,
+        ActiveWakeRoutineCount: input.Metrics.ActiveWakeRoutineCount,
+        NextScheduledWakeAt: input.Metrics.NextScheduledWakeAt
+            ? input.Metrics.NextScheduledWakeAt.toISOString()
+            : null,
+        GovernanceSummary: {
+            DisplayName: input.Governance.DisplayName,
+            Status: input.Governance.Status,
+            OnboardingStatus: input.Governance.OnboardingStatus,
+            CoordinationMode: input.Governance.CoordinationMode,
+            DefaultDataAccessMode: input.Governance.DefaultDataAccessMode,
+            EmailChannelMode: input.Governance.EmailChannelMode,
+            CalendarChannelMode: input.Governance.CalendarChannelMode,
+            PhoneChannelMode: input.Governance.PhoneChannelMode,
+            MessagingChannelMode: input.Governance.MessagingChannelMode,
+            AllowInterAgentCoordination: input.Governance.AllowInterAgentCoordination,
+            RequireApprovalForExternalComms: input.Governance.RequireApprovalForExternalComms,
+            RequireApprovalForFinancials: input.Governance.RequireApprovalForFinancials,
+            RequireApprovalForDestructiveActions: input.Governance.RequireApprovalForDestructiveActions,
+            AutoApproveAmountThreshold: input.Governance.AutoApproveAmountThreshold,
+        },
+        VisibleWakeRoutineNames: boundedRoutineNames,
+    };
+}
+/** 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');
+}
+//# sourceMappingURL=chief-of-staff-agent-context.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chief-of-staff-agent-context.js","sourceRoot":"","sources":["../../src/ChiefOfStaff/chief-of-staff-agent-context.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Pure, unit-testable helpers for the Chief of Staff application's pages (Overview,\n * Approvals & Wakes, Governance): their agent context, client tools and policy drafts.\n *\n * Core only: everything here reads core entities (`MJ: AI Agent User Policies`,\n * `MJ: User Routines`, `MJ: AI Agent Requests`). Business data such as priorities, tasks and\n * to-dos comes from Open Apps that add their own nav items to the Chief of Staff application\n * through `NavItem.*` application settings; core never names an Open App's entities.\n *\n * 🚨 SAFETY BOUNDARY 🚨\n * The Chief of Staff pages expose ONLY navigation / search /\n * refresh / detail-view tools to the co-agent. DELIBERATELY NOT exposed as client tools\n * (mutations stay human-driven in the UI):\n * - Approving or rejecting `MJ: AI Agent Requests`\n * - Modifying or saving `MJ: AI Agent User Policies` governance toggles / thresholds\n * - Triggering \"Wake Now\" or pausing/resuming `MJ: User Routines`\n *\n * Published context exposes only aggregate counts, the current page and search, governance\n * mode summaries, and bounded display names (capped at 25) — never raw request payloads,\n * custom instructions overrides, or private message content.\n */\n\nimport type {\n    MJAIAgentUserPolicyEntity,\n    MJUserRoutineEntity,\n    MJAIAgentRequestEntity,\n} from '@memberjunction/core-entities';\nimport { EscapeSQLString } from '@memberjunction/global';\nimport {\n    AGENT_CONTEXT_NAME_LIST_CAP,\n    BoundNameList,\n    ValidateEnumParam,\n    ValidateStringParam,\n    type AgentToolResult,\n} from '../shared/agent-tool-validation';\n\n/**\n * The pages serve one agent, identified by its metadata name. The id is resolved at runtime\n * through `AIEngineBase.GetAgentByName`, never hardcoded.\n */\nexport const CHIEF_OF_STAFF_AGENT_NAME = 'Chief of Staff';\n\n/** The name of the Chief of Staff application whose nav items open the pages. */\nexport const CHIEF_OF_STAFF_APP_NAME = 'Chief of Staff';\n\n/** The Chief of Staff application's own pages; each is one nav item. */\nexport type ChiefOfStaffPage = 'overview' | 'approvals-wakes' | 'governance';\nexport const CHIEF_OF_STAFF_PAGES: readonly ChiefOfStaffPage[] = [\n    'overview',\n    'approvals-wakes',\n    'governance',\n] as const;\n\n/** Each page's nav item label; must match the application's `DefaultNavItems`. */\nexport const CHIEF_OF_STAFF_PAGE_LABELS: Readonly<Record<ChiefOfStaffPage, string>> = {\n    overview: 'Overview',\n    'approvals-wakes': 'Approvals & Wakes',\n    governance: 'Governance',\n};\n\n/** Each page's Font Awesome icon; matches the application's `DefaultNavItems`. */\nexport const CHIEF_OF_STAFF_PAGE_ICONS: Readonly<Record<ChiefOfStaffPage, string>> = {\n    overview: 'fa-solid fa-compass',\n    'approvals-wakes': 'fa-solid fa-bell-concierge',\n    governance: 'fa-solid fa-shield-halved',\n};\n\nexport type PolicyStatusValue = MJAIAgentUserPolicyEntity['Status'];\nexport type PolicyCoordinationModeValue = MJAIAgentUserPolicyEntity['CoordinationMode'];\nexport type PolicyDataAccessModeValue = MJAIAgentUserPolicyEntity['DefaultDataAccessMode'];\nexport type PolicyEmailChannelModeValue = MJAIAgentUserPolicyEntity['EmailChannelMode'];\nexport type PolicyCalendarChannelModeValue = MJAIAgentUserPolicyEntity['CalendarChannelMode'];\nexport type PolicyPhoneChannelModeValue = MJAIAgentUserPolicyEntity['PhoneChannelMode'];\nexport type PolicyMessagingChannelModeValue = MJAIAgentUserPolicyEntity['MessagingChannelMode'];\nexport type RoutineStatusValue = MJUserRoutineEntity['Status'];\nexport type RequestStatusValue = MJAIAgentRequestEntity['Status'];\n\nexport interface RoutineSummaryItem {\n    ID: string;\n    Name: string;\n    Status: RoutineStatusValue;\n    ScheduleMode: MJUserRoutineEntity['ScheduleMode'];\n    CronExpression: string | null;\n    NextRunAt: Date | string | null;\n    LastRunAt: Date | string | null;\n    LastRunStatus: MJUserRoutineEntity['LastRunStatus'];\n}\n\n/** The status label the pages show for a routine: the entity's Status, or 'Fired' for a spent one-shot. */\nexport type RoutineDisplayStatusValue = RoutineSummaryItem['Status'] | 'Fired';\n\n/**\n * True for a one-shot routine that has run and has no next time: the dispatcher disables a one-shot\n * once it fires, so \"Disabled\" here means \"done\", not \"broken\". A one-shot still waiting for its\n * time is not spent, whatever it has run before (a manual run keeps the schedule); a one-shot that\n * was disabled before ever running is just disabled; a recurring routine is never spent.\n */\nexport function IsSpentOneShotRoutine(routine: Pick<RoutineSummaryItem, 'ScheduleMode' | 'NextRunAt' | 'LastRunAt' | 'Status'>): boolean {\n    return routine.ScheduleMode === 'OneShot'\n        && routine.Status === 'Disabled'\n        && routine.NextRunAt == null\n        && routine.LastRunAt != null;\n}\n\n/** 'Fired' for a spent one-shot, otherwise the routine's own Status. */\nexport function RoutineDisplayStatus(routine: Pick<RoutineSummaryItem, 'ScheduleMode' | 'NextRunAt' | 'LastRunAt' | 'Status'>): RoutineDisplayStatusValue {\n    return IsSpentOneShotRoutine(routine) ? 'Fired' : routine.Status;\n}\n\n/**\n * Display order for the wake schedule: routines with a next wake first, soonest first; then the\n * unscheduled (paused, or disabled before ever running); spent one-shots last, most recent first.\n * Returns a new array.\n */\nexport function SortRoutinesForDisplay<T extends Pick<RoutineSummaryItem, 'ScheduleMode' | 'NextRunAt' | 'LastRunAt' | 'Status'>>(routines: readonly T[]): T[] {\n    const rank = (r: T): number => (IsSpentOneShotRoutine(r) ? 2 : r.NextRunAt != null ? 0 : 1);\n    const time = (value: Date | string | null): number => {\n        const parsed = ParseOptionalDate(value);\n        return parsed ? parsed.getTime() : Number.POSITIVE_INFINITY;\n    };\n    return [...routines].sort((a, b) => {\n        const ra = rank(a);\n        const rb = rank(b);\n        if (ra !== rb) return ra - rb;\n        if (ra === 0) return time(a.NextRunAt) - time(b.NextRunAt);\n        if (ra === 2) return time(b.LastRunAt) - time(a.LastRunAt);\n        return 0;\n    });\n}\n\n/**\n * An outbound email waiting for approval, as the email action records it in the request's\n * `Comments` (JSON with Operation / From / To / CCRecipients / Subject / Body).\n */\nexport interface EmailApprovalDraft {\n    Operation: 'Send' | 'Reply' | 'Forward';\n    From: string | null;\n    To: string;\n    CC: string[];\n    Subject: string;\n    Body: string;\n}\n\n/**\n * Reads the email draft out of an approval request's Comments. Returns null when the comments are\n * empty, not JSON, or not an email (a call brief, say), so callers can show the draft only when\n * there is one. An older payload without `Operation` counts as a `Send` when To and Subject exist.\n */\nexport function ParseEmailApprovalPayload(comments: string | null | undefined): EmailApprovalDraft | null {\n    const text = comments?.trim();\n    if (!text || !text.startsWith('{')) {\n        return null;\n    }\n    let raw: unknown;\n    try {\n        raw = JSON.parse(text);\n    } catch {\n        return null;\n    }\n    if (!raw || typeof raw !== 'object') {\n        return null;\n    }\n    const record = raw as Record<string, unknown>;\n    const to = stringField(record, 'To');\n    const subject = stringField(record, 'Subject');\n    const body = stringField(record, 'Body');\n    if (to == null || subject == null || body == null) {\n        return null;\n    }\n    const operation = stringField(record, 'Operation');\n    const op: EmailApprovalDraft['Operation'] = operation === 'Reply' || operation === 'Forward' ? operation : 'Send';\n    const cc = Array.isArray(record['CCRecipients'])\n        ? (record['CCRecipients'] as unknown[]).filter((c): c is string => typeof c === 'string' && c.trim().length > 0)\n        : [];\n    return { Operation: op, From: stringField(record, 'From'), To: to, CC: cc, Subject: subject, Body: body };\n}\n\n/** The draft as plain text for a mail client: headers, a blank line, then the body. */\nexport function FormatEmailDraftForClipboard(draft: EmailApprovalDraft): string {\n    const lines = [`To: ${draft.To}`];\n    if (draft.CC.length > 0) {\n        lines.push(`CC: ${draft.CC.join(', ')}`);\n    }\n    lines.push(`Subject: ${draft.Subject}`, '', draft.Body);\n    return lines.join('\\n');\n}\n\nfunction stringField(record: Record<string, unknown>, key: string): string | null {\n    const value = record[key];\n    return typeof value === 'string' ? value : null;\n}\n\nexport interface RequestSummaryItem {\n    ID: string;\n    Request: string;\n    Status: RequestStatusValue;\n    Priority: number;\n    RequestedAt: Date | string;\n    ExpiresAt: Date | string | null;\n    RequestType?: MJAIAgentRequestEntity['RequestType'];\n    RequestTypeID?: MJAIAgentRequestEntity['RequestTypeID'];\n}\n\nexport interface PolicyGovernanceSummary {\n    HasPolicyRecord: boolean;\n    DisplayName: string;\n    Status: PolicyStatusValue;\n    OnboardingStatus: MJAIAgentUserPolicyEntity['OnboardingStatus'];\n    CoordinationMode: PolicyCoordinationModeValue;\n    DefaultDataAccessMode: PolicyDataAccessModeValue;\n    EmailChannelMode: PolicyEmailChannelModeValue;\n    CalendarChannelMode: PolicyCalendarChannelModeValue;\n    PhoneChannelMode: PolicyPhoneChannelModeValue;\n    MessagingChannelMode: PolicyMessagingChannelModeValue;\n    AllowInterAgentCoordination: boolean;\n    RequireApprovalForExternalComms: boolean;\n    RequireApprovalForFinancials: boolean;\n    RequireApprovalForDestructiveActions: boolean;\n    AutoApproveAmountThreshold: number | null;\n}\n\n/** The Governance page's editable copy of the user's policy. */\nexport interface GovernancePolicyDraft {\n    DisplayNameOverride: string;\n    Status: PolicyStatusValue;\n    OnboardingStatus: MJAIAgentUserPolicyEntity['OnboardingStatus'];\n    CoordinationMode: PolicyCoordinationModeValue;\n    DefaultDataAccessMode: PolicyDataAccessModeValue;\n    EmailChannelMode: PolicyEmailChannelModeValue;\n    CalendarChannelMode: PolicyCalendarChannelModeValue;\n    PhoneChannelMode: PolicyPhoneChannelModeValue;\n    MessagingChannelMode: PolicyMessagingChannelModeValue;\n    AllowInterAgentCoordination: boolean;\n    RequireApprovalForExternalComms: boolean;\n    RequireApprovalForFinancials: boolean;\n    RequireApprovalForDestructiveActions: boolean;\n    AutoApproveAmountThreshold: number | null;\n    InstructionsOverride: string;\n}\n\n/** The draft shown before the user has a policy record. */\nexport function CreateDefaultPolicyDraft(): GovernancePolicyDraft {\n    return {\n        DisplayNameOverride: 'Chief of Staff',\n        Status: 'Active',\n        OnboardingStatus: 'Completed',\n        CoordinationMode: 'Coordinator',\n        DefaultDataAccessMode: 'UserCeiling',\n        EmailChannelMode: 'DraftOnly',\n        CalendarChannelMode: 'ProposeWithApproval',\n        PhoneChannelMode: 'Disabled',\n        MessagingChannelMode: 'Enabled',\n        AllowInterAgentCoordination: true,\n        RequireApprovalForExternalComms: true,\n        RequireApprovalForFinancials: true,\n        RequireApprovalForDestructiveActions: true,\n        AutoApproveAmountThreshold: 0,\n        InstructionsOverride: '',\n    };\n}\n\n/** A draft copied from the user's policy record, or the default draft when there is none. */\nexport function BuildPolicyDraftFromEntity(entity: MJAIAgentUserPolicyEntity | null): GovernancePolicyDraft {\n    if (!entity) {\n        return CreateDefaultPolicyDraft();\n    }\n    return {\n        DisplayNameOverride: entity.DisplayNameOverride ?? '',\n        Status: entity.Status,\n        OnboardingStatus: entity.OnboardingStatus,\n        CoordinationMode: entity.CoordinationMode,\n        DefaultDataAccessMode: entity.DefaultDataAccessMode,\n        EmailChannelMode: entity.EmailChannelMode,\n        CalendarChannelMode: entity.CalendarChannelMode,\n        PhoneChannelMode: entity.PhoneChannelMode,\n        MessagingChannelMode: entity.MessagingChannelMode,\n        AllowInterAgentCoordination: entity.AllowInterAgentCoordination,\n        RequireApprovalForExternalComms: entity.RequireApprovalForExternalComms,\n        RequireApprovalForFinancials: entity.RequireApprovalForFinancials,\n        RequireApprovalForDestructiveActions: entity.RequireApprovalForDestructiveActions,\n        AutoApproveAmountThreshold: entity.AutoApproveAmountThreshold,\n        InstructionsOverride: entity.InstructionsOverride ?? '',\n    };\n}\n\n/** The display name: the draft's override, or 'My Chief of Staff'. */\nexport function ChiefOfStaffDisplayName(draft: Pick<GovernancePolicyDraft, 'DisplayNameOverride'>): string {\n    const override = draft.DisplayNameOverride.trim();\n    return override.length > 0 ? override : 'My Chief of Staff';\n}\n\n/** The governance summary published in the agent context. */\nexport function BuildGovernanceSummary(draft: GovernancePolicyDraft, hasPolicyRecord: boolean): PolicyGovernanceSummary {\n    return {\n        HasPolicyRecord: hasPolicyRecord,\n        DisplayName: ChiefOfStaffDisplayName(draft),\n        Status: draft.Status,\n        OnboardingStatus: draft.OnboardingStatus,\n        CoordinationMode: draft.CoordinationMode,\n        DefaultDataAccessMode: draft.DefaultDataAccessMode,\n        EmailChannelMode: draft.EmailChannelMode,\n        CalendarChannelMode: draft.CalendarChannelMode,\n        PhoneChannelMode: draft.PhoneChannelMode,\n        MessagingChannelMode: draft.MessagingChannelMode,\n        AllowInterAgentCoordination: draft.AllowInterAgentCoordination,\n        RequireApprovalForExternalComms: draft.RequireApprovalForExternalComms,\n        RequireApprovalForFinancials: draft.RequireApprovalForFinancials,\n        RequireApprovalForDestructiveActions: draft.RequireApprovalForDestructiveActions,\n        AutoApproveAmountThreshold: draft.AutoApproveAmountThreshold,\n    };\n}\n\nexport interface ChiefOfStaffMetrics {\n    PendingApprovalCount: number;\n    HighPriorityPendingCount: number;\n    ActiveWakeRoutineCount: number;\n    NextScheduledWakeAt: Date | null;\n}\n\nexport interface ChiefOfStaffAgentContextInput {\n    Page: ChiefOfStaffPage;\n    SearchText: string;\n    Metrics: ChiefOfStaffMetrics;\n    Governance: PolicyGovernanceSummary;\n    Routines: readonly RoutineSummaryItem[];\n    PendingRequests: readonly RequestSummaryItem[];\n}\n\nexport type AgentContextScalar = string | number | boolean | null;\nexport type AgentContextRecord = Record<\n    string,\n    AgentContextScalar | string[] | Record<string, AgentContextScalar>\n>;\n\n/**\n * Returns `true` when an `MJ: AI Agent Requests` row represents an actionable approval or\n * review request for the Chief of Staff's Pending Approvals queue, and `false` when it\n * is a conversational `Information` turn created by `BaseAgent` when ending a chat turn.\n */\nexport function IsApprovalRequest(req: {\n    RequestType?: MJAIAgentRequestEntity['RequestType'] | undefined;\n    RequestTypeID?: MJAIAgentRequestEntity['RequestTypeID'] | undefined;\n}): boolean {\n    // The RequestType virtual field carries the type name; classify on it alone.\n    const typeName = req.RequestType?.trim().toLowerCase() ?? '';\n    return typeName !== 'information';\n}\n\nexport function ParseOptionalDate(val: Date | string | null | undefined): Date | null {\n    if (!val) {\n        return null;\n    }\n    if (val instanceof Date) {\n        return isNaN(val.getTime()) ? null : val;\n    }\n    const parsed = new Date(val);\n    return isNaN(parsed.getTime()) ? null : parsed;\n}\n\n/** ExtraFilters for the pages' three core-entity queries. Every clause is bound to the current user: the pages never show another user's Chief of Staff data. */\nexport interface ChiefOfStaffScopeFilters {\n    Policy: string;\n    Routines: string;\n    Requests: string;\n}\n\nexport function BuildChiefOfStaffScopeFilters(currentUserId: string, chiefOfStaffAgentId: string): ChiefOfStaffScopeFilters {\n    const user = EscapeSQLString(currentUserId);\n    const agent = EscapeSQLString(chiefOfStaffAgentId);\n    return {\n        Policy: `AgentID = '${agent}' AND UserID = '${user}'`,\n        Routines: `UserID = '${user}' AND (RoutineType = 'AgentWake' OR TargetID = '${agent}')`,\n        Requests: `AgentID = '${agent}' AND RequestForUserID = '${user}' AND (RequestType IS NULL OR RequestType <> 'Information')`,\n    };\n}\n\n\n/** The core counts: pending approvals and active wakes. */\nexport function CalculateChiefOfStaffMetrics(\n    routines: readonly RoutineSummaryItem[],\n    requests: readonly RequestSummaryItem[],\n): ChiefOfStaffMetrics {\n    const pendingRequests = requests.filter(\n        (r) => r.Status === 'Requested' && IsApprovalRequest(r),\n    );\n    const highPriorityPending = pendingRequests.filter((r) => r.Priority >= 51);\n\n    const activeWakeRoutines = routines.filter((r) => r.Status === 'Active');\n    let nextScheduledWakeAt: Date | null = null;\n    for (const routine of activeWakeRoutines) {\n        const nextRun = ParseOptionalDate(routine.NextRunAt);\n        if (nextRun && (!nextScheduledWakeAt || nextRun.getTime() < nextScheduledWakeAt.getTime())) {\n            nextScheduledWakeAt = nextRun;\n        }\n    }\n\n    return {\n        PendingApprovalCount: pendingRequests.length,\n        HighPriorityPendingCount: highPriorityPending.length,\n        ActiveWakeRoutineCount: activeWakeRoutines.length,\n        NextScheduledWakeAt: nextScheduledWakeAt,\n    };\n}\n\nexport function BuildChiefOfStaffAgentContext(\n    input: ChiefOfStaffAgentContextInput,\n): AgentContextRecord {\n    const routineNames = input.Routines.map((r) => `${r.Name} (${r.Status})`).filter((n) => !!n);\n    const boundedRoutineNames = BoundNameList(routineNames, AGENT_CONTEXT_NAME_LIST_CAP);\n\n    return {\n        Surface: 'ChiefOfStaff',\n        Page: input.Page,\n        SearchText: input.SearchText,\n        PendingApprovalCount: input.Metrics.PendingApprovalCount,\n        HighPriorityPendingCount: input.Metrics.HighPriorityPendingCount,\n        ActiveWakeRoutineCount: input.Metrics.ActiveWakeRoutineCount,\n        NextScheduledWakeAt: input.Metrics.NextScheduledWakeAt\n            ? input.Metrics.NextScheduledWakeAt.toISOString()\n            : null,\n        GovernanceSummary: {\n            DisplayName: input.Governance.DisplayName,\n            Status: input.Governance.Status,\n            OnboardingStatus: input.Governance.OnboardingStatus,\n            CoordinationMode: input.Governance.CoordinationMode,\n            DefaultDataAccessMode: input.Governance.DefaultDataAccessMode,\n            EmailChannelMode: input.Governance.EmailChannelMode,\n            CalendarChannelMode: input.Governance.CalendarChannelMode,\n            PhoneChannelMode: input.Governance.PhoneChannelMode,\n            MessagingChannelMode: input.Governance.MessagingChannelMode,\n            AllowInterAgentCoordination: input.Governance.AllowInterAgentCoordination,\n            RequireApprovalForExternalComms: input.Governance.RequireApprovalForExternalComms,\n            RequireApprovalForFinancials: input.Governance.RequireApprovalForFinancials,\n            RequireApprovalForDestructiveActions:\n                input.Governance.RequireApprovalForDestructiveActions,\n            AutoApproveAmountThreshold: input.Governance.AutoApproveAmountThreshold,\n        },\n        VisibleWakeRoutineNames: boundedRoutineNames,\n    };\n}\n\n/** Validates a page parameter against the Chief of Staff application's own pages. */\nexport function ValidateChiefOfStaffPageParam(\n    raw: string | number | boolean | null | undefined,\n): { ok: true; value: ChiefOfStaffPage } | { ok: false; result: AgentToolResult } {\n    return ValidateEnumParam(raw, CHIEF_OF_STAFF_PAGES, 'page');\n}\n\nexport function ValidateSearchQueryParam(\n    raw: string | number | boolean | null | undefined,\n): { ok: true; value: string } | { ok: false; result: AgentToolResult } {\n    return ValidateStringParam(raw, 'query');\n}\n"]}

package/dist/ChiefOfStaff/chief-of-staff-approvals.component.d.ts

@@ -0,0 +1,29 @@
+import { MJAIAgentRequestEntity, MJUserRoutineEntity } from '@memberjunction/core-entities';
+import { ChiefOfStaffPage } from './chief-of-staff-agent-context';
+import { BaseChiefOfStaffPage, ChiefOfStaffClientTool } from './chief-of-staff-page-base';
+import * as i0 from "@angular/core";
+/**
+ * The Chief of Staff application's Approvals & Wakes page: every pending approval with its
+ * recent decisions, and every wake routine with Wake Now, pause and its briefings. The search
+ * box filters both lists and round-trips through the `search` query param.
+ */
+export declare class ChiefOfStaffApprovalsComponent extends BaseChiefOfStaffPage {
+    protected readonly Page: ChiefOfStaffPage;
+    private initialParamsApplied;
+    /** When true, the wake list also shows spent one-shots (reminders that have fired). Off by default. */
+    ShowFiredRoutines: boolean;
+    get RecentResolvedRequests(): MJAIAgentRequestEntity[];
+    /** Spent one-shots: reminders and one-time wakes that have already fired. */
+    get FiredRoutineCount(): number;
+    get FilteredRoutines(): MJUserRoutineEntity[];
+    ToggleShowFiredRoutines(): void;
+    OnSearchChange(value: string): void;
+    protected OnPageInit(): void;
+    protected OnQueryParamsChanged(params: Record<string, string>, _source: 'popstate' | 'deeplink'): void;
+    private syncQueryParams;
+    protected PageAgentTools(): ChiefOfStaffClientTool[];
+    static ɵfac: i0.ɵɵFactoryDeclaration<ChiefOfStaffApprovalsComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ChiefOfStaffApprovalsComponent, "mj-chief-of-staff-approvals", never, {}, {}, never, never, false, never>;
+}
+export declare function LoadChiefOfStaffApprovals(): void;
+//# sourceMappingURL=chief-of-staff-approvals.component.d.ts.map

package/dist/ChiefOfStaff/chief-of-staff-approvals.component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chief-of-staff-approvals.component.d.ts","sourceRoot":"","sources":["../../src/ChiefOfStaff/chief-of-staff-approvals.component.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAG5F,OAAO,EAAE,gBAAgB,EAAsE,MAAM,gCAAgC,CAAC;AACtI,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;;AAE1F;;;;GAIG;AACH,qBAQa,8BAA+B,SAAQ,oBAAoB;IACpE,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAqB;IAC9D,OAAO,CAAC,oBAAoB,CAAS;IAErC,uGAAuG;IAChG,iBAAiB,UAAS;IAEjC,IAAW,sBAAsB,IAAI,sBAAsB,EAAE,CAE5D;IAED,6EAA6E;IAC7E,IAAW,iBAAiB,IAAI,MAAM,CAErC;IAED,IAAW,gBAAgB,IAAI,mBAAmB,EAAE,CAWnD;IAEM,uBAAuB,IAAI,IAAI;IAK/B,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;cAOvB,UAAU,IAAI,IAAI;cAKlB,oBAAoB,CACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,OAAO,EAAE,UAAU,GAAG,UAAU,GACjC,IAAI;IAMP,OAAO,CAAC,eAAe;cASJ,cAAc,IAAI,sBAAsB,EAAE;yCAhEpD,8BAA8B;2CAA9B,8BAA8B;CAkG1C;AAED,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD"}