@memberjunction/ng-user-routines 0.0.0 → 5.45.1

package/dist/lib/routine-target-catalog.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Loads the pickable routine targets (Agents / Actions / Prompts) and the Active AI
+ * Skills from the already-cached metadata engines — provider-scoped, lazy Config, no
+ * bespoke RunView round-trips. Shared by the routines list (id → name resolution) and
+ * the editor (target / skill pickers).
+ */
+import { IMetadataProvider } from '@memberjunction/core';
+/** A pickable target (agent, action, or prompt). */
+export interface RoutineTargetOption {
+    ID: string;
+    Name: string;
+    Description: string | null;
+}
+/** A pickable AI Skill for RequestedSkillIDs. */
+export interface RoutineSkillOption {
+    ID: string;
+    Name: string;
+    Description: string | null;
+    IconClass: string | null;
+    Color: string | null;
+}
+/** The full catalog of routine-pickable targets + skills, plus an id → name map. */
+export interface RoutineTargetCatalog {
+    /** Active agents, EXCLUDING agents whose type is the Realtime agent type (interactive-only). */
+    Agents: RoutineTargetOption[];
+    /** Active actions. */
+    Actions: RoutineTargetOption[];
+    /** Active prompts. */
+    Prompts: RoutineTargetOption[];
+    /** Active AI Skills (for Agent targets' RequestedSkillIDs). */
+    Skills: RoutineSkillOption[];
+    /**
+     * Display name for ANY known target id (normalized), regardless of status — so
+     * routines pointing at since-deactivated targets still render a name.
+     */
+    NameByID: Map<string, string>;
+    /**
+     * Font Awesome icon class for ANY known agent id (normalized) that has an
+     * IconClass set. Consumers fall back to 'fa-solid fa-robot' when absent.
+     */
+    IconByID: Map<string, string>;
+}
+/**
+ * Builds the catalog from the provider-scoped AI + Action engines. Both engines cache
+ * after their first Config, so repeated calls are cheap.
+ */
+export declare function LoadRoutineTargetCatalog(provider: IMetadataProvider): Promise<RoutineTargetCatalog>;
+//# sourceMappingURL=routine-target-catalog.d.ts.map

package/dist/lib/routine-target-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routine-target-catalog.d.ts","sourceRoot":"","sources":["../../src/lib/routine-target-catalog.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAKzD,oDAAoD;AACpD,MAAM,WAAW,mBAAmB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,iDAAiD;AACjD,MAAM,WAAW,kBAAkB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,oFAAoF;AACpF,MAAM,WAAW,oBAAoB;IACjC,gGAAgG;IAChG,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,sBAAsB;IACtB,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,sBAAsB;IACtB,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,+DAA+D;IAC/D,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B;;;OAGG;IACH,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B;;;OAGG;IACH,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA2DzG"}

package/dist/lib/routine-target-catalog.js

@@ -0,0 +1,59 @@
+import { AIEngineBase } from '@memberjunction/ai-engine-base';
+import { ActionEngineBase } from '@memberjunction/actions-base';
+import { NormalizeUUID } from '@memberjunction/global';
+/**
+ * Builds the catalog from the provider-scoped AI + Action engines. Both engines cache
+ * after their first Config, so repeated calls are cheap.
+ */
+export async function LoadRoutineTargetCatalog(provider) {
+    const aiEngine = AIEngineBase.GetProviderInstance(provider, AIEngineBase);
+    const actionEngine = ActionEngineBase.GetProviderInstance(provider, ActionEngineBase);
+    await Promise.all([
+        aiEngine.Config(false, undefined, provider),
+        actionEngine.Config(false, undefined, provider),
+    ]);
+    // Resolve the Realtime agent type by NAME from metadata — never by hardcoded ID.
+    const realtimeTypeIDs = new Set(aiEngine.AgentTypes
+        .filter((t) => t.Name?.trim().toLowerCase() === 'realtime')
+        .map((t) => NormalizeUUID(t.ID)));
+    const nameByID = new Map();
+    const iconByID = new Map();
+    const byName = (a, b) => a.Name.localeCompare(b.Name);
+    const agents = aiEngine.Agents
+        .filter((a) => {
+        nameByID.set(NormalizeUUID(a.ID), a.Name ?? '');
+        if (a.IconClass) {
+            iconByID.set(NormalizeUUID(a.ID), a.IconClass);
+        }
+        const isRealtime = a.TypeID != null && realtimeTypeIDs.has(NormalizeUUID(a.TypeID));
+        return a.Status === 'Active' && !isRealtime;
+    })
+        .map((a) => ({ ID: a.ID, Name: a.Name ?? '', Description: a.Description ?? null }))
+        .sort(byName);
+    const actions = actionEngine.Actions
+        .filter((a) => {
+        nameByID.set(NormalizeUUID(a.ID), a.Name ?? '');
+        return a.Status === 'Active';
+    })
+        .map((a) => ({ ID: a.ID, Name: a.Name ?? '', Description: a.Description ?? null }))
+        .sort(byName);
+    const prompts = aiEngine.Prompts
+        .filter((prompt) => {
+        nameByID.set(NormalizeUUID(prompt.ID), prompt.Name ?? '');
+        return prompt.Status === 'Active';
+    })
+        .map((prompt) => ({ ID: prompt.ID, Name: prompt.Name ?? '', Description: prompt.Description ?? null }))
+        .sort(byName);
+    const skills = aiEngine.Skills
+        .filter((s) => s.Status === 'Active')
+        .map((s) => ({
+        ID: s.ID,
+        Name: s.Name ?? '',
+        Description: s.Description ?? null,
+        IconClass: s.IconClass ?? null,
+        Color: s.Color ?? null,
+    }))
+        .sort(byName);
+    return { Agents: agents, Actions: actions, Prompts: prompts, Skills: skills, NameByID: nameByID, IconByID: iconByID };
+}
+//# sourceMappingURL=routine-target-catalog.js.map

package/dist/lib/routine-target-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routine-target-catalog.js","sourceRoot":"","sources":["../../src/lib/routine-target-catalog.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Loads the pickable routine targets (Agents / Actions / Prompts) and the Active AI\n * Skills from the already-cached metadata engines — provider-scoped, lazy Config, no\n * bespoke RunView round-trips. Shared by the routines list (id → name resolution) and\n * the editor (target / skill pickers).\n */\nimport { IMetadataProvider } from '@memberjunction/core';\nimport { AIEngineBase } from '@memberjunction/ai-engine-base';\nimport { ActionEngineBase } from '@memberjunction/actions-base';\nimport { NormalizeUUID } from '@memberjunction/global';\n\n/** A pickable target (agent, action, or prompt). */\nexport interface RoutineTargetOption {\n    ID: string;\n    Name: string;\n    Description: string | null;\n}\n\n/** A pickable AI Skill for RequestedSkillIDs. */\nexport interface RoutineSkillOption {\n    ID: string;\n    Name: string;\n    Description: string | null;\n    IconClass: string | null;\n    Color: string | null;\n}\n\n/** The full catalog of routine-pickable targets + skills, plus an id → name map. */\nexport interface RoutineTargetCatalog {\n    /** Active agents, EXCLUDING agents whose type is the Realtime agent type (interactive-only). */\n    Agents: RoutineTargetOption[];\n    /** Active actions. */\n    Actions: RoutineTargetOption[];\n    /** Active prompts. */\n    Prompts: RoutineTargetOption[];\n    /** Active AI Skills (for Agent targets' RequestedSkillIDs). */\n    Skills: RoutineSkillOption[];\n    /**\n     * Display name for ANY known target id (normalized), regardless of status — so\n     * routines pointing at since-deactivated targets still render a name.\n     */\n    NameByID: Map<string, string>;\n    /**\n     * Font Awesome icon class for ANY known agent id (normalized) that has an\n     * IconClass set. Consumers fall back to 'fa-solid fa-robot' when absent.\n     */\n    IconByID: Map<string, string>;\n}\n\n/**\n * Builds the catalog from the provider-scoped AI + Action engines. Both engines cache\n * after their first Config, so repeated calls are cheap.\n */\nexport async function LoadRoutineTargetCatalog(provider: IMetadataProvider): Promise<RoutineTargetCatalog> {\n    const aiEngine = AIEngineBase.GetProviderInstance<AIEngineBase>(provider, AIEngineBase) as AIEngineBase;\n    const actionEngine = ActionEngineBase.GetProviderInstance<ActionEngineBase>(provider, ActionEngineBase) as ActionEngineBase;\n    await Promise.all([\n        aiEngine.Config(false, undefined, provider),\n        actionEngine.Config(false, undefined, provider),\n    ]);\n\n    // Resolve the Realtime agent type by NAME from metadata — never by hardcoded ID.\n    const realtimeTypeIDs = new Set<string>(\n        aiEngine.AgentTypes\n            .filter((t) => t.Name?.trim().toLowerCase() === 'realtime')\n            .map((t) => NormalizeUUID(t.ID))\n    );\n\n    const nameByID = new Map<string, string>();\n    const iconByID = new Map<string, string>();\n    const byName = (a: { Name: string }, b: { Name: string }) => a.Name.localeCompare(b.Name);\n\n    const agents = aiEngine.Agents\n        .filter((a) => {\n            nameByID.set(NormalizeUUID(a.ID), a.Name ?? '');\n            if (a.IconClass) {\n                iconByID.set(NormalizeUUID(a.ID), a.IconClass);\n            }\n            const isRealtime = a.TypeID != null && realtimeTypeIDs.has(NormalizeUUID(a.TypeID));\n            return a.Status === 'Active' && !isRealtime;\n        })\n        .map((a) => ({ ID: a.ID, Name: a.Name ?? '', Description: a.Description ?? null }))\n        .sort(byName);\n\n    const actions = actionEngine.Actions\n        .filter((a) => {\n            nameByID.set(NormalizeUUID(a.ID), a.Name ?? '');\n            return a.Status === 'Active';\n        })\n        .map((a) => ({ ID: a.ID, Name: a.Name ?? '', Description: a.Description ?? null }))\n        .sort(byName);\n\n    const prompts = aiEngine.Prompts\n        .filter((prompt) => {\n            nameByID.set(NormalizeUUID(prompt.ID), prompt.Name ?? '');\n            return prompt.Status === 'Active';\n        })\n        .map((prompt) => ({ ID: prompt.ID, Name: prompt.Name ?? '', Description: prompt.Description ?? null }))\n        .sort(byName);\n\n    const skills = aiEngine.Skills\n        .filter((s) => s.Status === 'Active')\n        .map((s) => ({\n            ID: s.ID,\n            Name: s.Name ?? '',\n            Description: s.Description ?? null,\n            IconClass: s.IconClass ?? null,\n            Color: s.Color ?? null,\n        }))\n        .sort(byName);\n\n    return { Agents: agents, Actions: actions, Prompts: prompts, Skills: skills, NameByID: nameByID, IconByID: iconByID };\n}\n"]}

package/dist/lib/routine-ui-helpers.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Pure display / serialization helpers shared by the User Routines components.
+ * No Angular or MJ runtime dependencies — unit-testable in isolation.
+ */
+import type { MJUserRoutineEntity } from '@memberjunction/core-entities';
+/** Chip variants aligned with the shared status-token vocabulary. */
+export type RoutineChipVariant = 'success' | 'warning' | 'error' | 'info' | 'muted';
+/** Maps a routine lifecycle status to a chip variant. */
+export declare function RoutineStatusVariant(status: MJUserRoutineEntity['Status']): RoutineChipVariant;
+/** Maps a run outcome status to a chip variant. */
+export declare function RunStatusVariant(status: string | null | undefined): RoutineChipVariant;
+/** Font Awesome icon class for a routine target type. */
+export declare function TargetTypeIcon(targetType: MJUserRoutineEntity['TargetType']): string;
+/**
+ * Compact relative-time label ("3m ago", "in 2h", "just now"). Returns an empty
+ * string for null input. `now` is injectable for tests.
+ */
+export declare function FormatRelativeTime(date: Date | null | undefined, now?: Date): string;
+/** Duration between two timestamps as "4s", "2m 10s", "1h 4m". Empty when incomplete. */
+export declare function FormatDuration(start: Date | null | undefined, end: Date | null | undefined): string;
+/**
+ * Parses the RequestedSkillIDs JSON column into a string array. Tolerant: bad JSON,
+ * non-array shapes, and non-string members all collapse to an empty/filtered array.
+ */
+export declare function ParseSkillIDs(raw: string | null | undefined): string[];
+/** Serializes a skill ID array to the JSON column value (null when empty). */
+export declare function SerializeSkillIDs(ids: readonly string[]): string | null;
+/** Validates optional JSON text (StartingPayload). Blank is valid (stored as NULL). */
+export declare function ValidateOptionalJson(text: string | null | undefined): {
+    Valid: boolean;
+    Error?: string;
+};
+/** Very light email shape check for external recipients (not RFC-complete on purpose). */
+export declare function IsPlausibleEmail(email: string): boolean;
+/**
+ * Converts a Date to the string an `<input type="datetime-local">` expects
+ * ("YYYY-MM-DDTHH:MM", local time). Empty string for null.
+ */
+export declare function ToDateTimeLocal(date: Date | null | undefined): string;
+/** Parses a datetime-local string back to a Date (null for blank/invalid). */
+export declare function FromDateTimeLocal(value: string | null | undefined): Date | null;
+/**
+ * The browser's IANA timezone list via Intl (ES2022), with a small static fallback for
+ * older runtimes. The current zone is included by construction on modern browsers.
+ */
+export declare function GetTimezoneOptions(): string[];
+/** The user's current IANA timezone (falls back to UTC). */
+export declare function GetLocalTimezone(): string;
+//# sourceMappingURL=routine-ui-helpers.d.ts.map

package/dist/lib/routine-ui-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routine-ui-helpers.d.ts","sourceRoot":"","sources":["../../src/lib/routine-ui-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,qEAAqE;AACrE,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAEpF,yDAAyD;AACzD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,mBAAmB,CAAC,QAAQ,CAAC,GAAG,kBAAkB,CAO9F;AAED,mDAAmD;AACnD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,kBAAkB,CAQtF;AAED,yDAAyD;AACzD,wBAAgB,cAAc,CAAC,UAAU,EAAE,mBAAmB,CAAC,YAAY,CAAC,GAAG,MAAM,CAOpF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,CA6BhG;AAED,yFAAyF;AACzF,wBAAgB,cAAc,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAmBnG;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,EAAE,CAatE;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAGvE;AAED,uFAAuF;AACvF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAWxG;AAED,0FAA0F;AAC1F,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAUrE;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,GAAG,IAAI,CAO/E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAW7C;AAED,4DAA4D;AAC5D,wBAAgB,gBAAgB,IAAI,MAAM,CAMzC"}

package/dist/lib/routine-ui-helpers.js

@@ -0,0 +1,174 @@
+/** Maps a routine lifecycle status to a chip variant. */
+export function RoutineStatusVariant(status) {
+    switch (status) {
+        case 'Active': return 'success';
+        case 'Paused': return 'warning';
+        case 'Disabled': return 'muted';
+        default: return 'muted';
+    }
+}
+/** Maps a run outcome status to a chip variant. */
+export function RunStatusVariant(status) {
+    switch (status) {
+        case 'Success': return 'success';
+        case 'Failed': return 'error';
+        case 'Running': return 'info';
+        case 'Skipped': return 'muted';
+        default: return 'muted';
+    }
+}
+/** Font Awesome icon class for a routine target type. */
+export function TargetTypeIcon(targetType) {
+    switch (targetType) {
+        case 'Agent': return 'fa-solid fa-robot';
+        case 'Action': return 'fa-solid fa-bolt';
+        case 'Prompt': return 'fa-solid fa-comment-dots';
+        default: return 'fa-solid fa-circle-question';
+    }
+}
+/**
+ * Compact relative-time label ("3m ago", "in 2h", "just now"). Returns an empty
+ * string for null input. `now` is injectable for tests.
+ */
+export function FormatRelativeTime(date, now = new Date()) {
+    if (!date) {
+        return '';
+    }
+    const target = date instanceof Date ? date : new Date(date);
+    if (isNaN(target.getTime())) {
+        return '';
+    }
+    const diffMs = target.getTime() - now.getTime();
+    const absMs = Math.abs(diffMs);
+    const future = diffMs > 0;
+    if (absMs < 60_000) {
+        return future ? 'in <1m' : 'just now';
+    }
+    const units = [
+        { ms: 86_400_000 * 365, label: 'y' },
+        { ms: 86_400_000 * 30, label: 'mo' },
+        { ms: 86_400_000, label: 'd' },
+        { ms: 3_600_000, label: 'h' },
+        { ms: 60_000, label: 'm' },
+    ];
+    for (const unit of units) {
+        if (absMs >= unit.ms) {
+            const count = Math.floor(absMs / unit.ms);
+            return future ? `in ${count}${unit.label}` : `${count}${unit.label} ago`;
+        }
+    }
+    return future ? 'in <1m' : 'just now';
+}
+/** Duration between two timestamps as "4s", "2m 10s", "1h 4m". Empty when incomplete. */
+export function FormatDuration(start, end) {
+    if (!start || !end) {
+        return '';
+    }
+    const startMs = new Date(start).getTime();
+    const endMs = new Date(end).getTime();
+    if (isNaN(startMs) || isNaN(endMs) || endMs < startMs) {
+        return '';
+    }
+    const totalSeconds = Math.round((endMs - startMs) / 1000);
+    if (totalSeconds < 60) {
+        return `${totalSeconds}s`;
+    }
+    const totalMinutes = Math.floor(totalSeconds / 60);
+    if (totalMinutes < 60) {
+        return `${totalMinutes}m ${totalSeconds % 60}s`;
+    }
+    const hours = Math.floor(totalMinutes / 60);
+    return `${hours}h ${totalMinutes % 60}m`;
+}
+/**
+ * Parses the RequestedSkillIDs JSON column into a string array. Tolerant: bad JSON,
+ * non-array shapes, and non-string members all collapse to an empty/filtered array.
+ */
+export function ParseSkillIDs(raw) {
+    if (!raw || raw.trim().length === 0) {
+        return [];
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed)) {
+            return [];
+        }
+        return parsed.filter((item) => typeof item === 'string' && item.length > 0);
+    }
+    catch {
+        return [];
+    }
+}
+/** Serializes a skill ID array to the JSON column value (null when empty). */
+export function SerializeSkillIDs(ids) {
+    const clean = ids.filter((id) => id && id.length > 0);
+    return clean.length > 0 ? JSON.stringify(clean) : null;
+}
+/** Validates optional JSON text (StartingPayload). Blank is valid (stored as NULL). */
+export function ValidateOptionalJson(text) {
+    const trimmed = (text ?? '').trim();
+    if (trimmed.length === 0) {
+        return { Valid: true };
+    }
+    try {
+        JSON.parse(trimmed);
+        return { Valid: true };
+    }
+    catch (e) {
+        return { Valid: false, Error: e instanceof Error ? e.message : 'Invalid JSON' };
+    }
+}
+/** Very light email shape check for external recipients (not RFC-complete on purpose). */
+export function IsPlausibleEmail(email) {
+    return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email.trim());
+}
+/**
+ * Converts a Date to the string an `<input type="datetime-local">` expects
+ * ("YYYY-MM-DDTHH:MM", local time). Empty string for null.
+ */
+export function ToDateTimeLocal(date) {
+    if (!date) {
+        return '';
+    }
+    const d = date instanceof Date ? date : new Date(date);
+    if (isNaN(d.getTime())) {
+        return '';
+    }
+    const pad = (n) => n.toString().padStart(2, '0');
+    return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}T${pad(d.getHours())}:${pad(d.getMinutes())}`;
+}
+/** Parses a datetime-local string back to a Date (null for blank/invalid). */
+export function FromDateTimeLocal(value) {
+    const trimmed = (value ?? '').trim();
+    if (!trimmed) {
+        return null;
+    }
+    const parsed = new Date(trimmed);
+    return isNaN(parsed.getTime()) ? null : parsed;
+}
+/**
+ * The browser's IANA timezone list via Intl (ES2022), with a small static fallback for
+ * older runtimes. The current zone is included by construction on modern browsers.
+ */
+export function GetTimezoneOptions() {
+    if (typeof Intl.supportedValuesOf === 'function') {
+        return Intl.supportedValuesOf('timeZone');
+    }
+    return [
+        'UTC',
+        'America/New_York', 'America/Chicago', 'America/Denver', 'America/Los_Angeles',
+        'Europe/London', 'Europe/Paris', 'Europe/Berlin',
+        'Asia/Tokyo', 'Asia/Shanghai', 'Asia/Kolkata',
+        'Australia/Sydney'
+    ];
+}
+/** The user's current IANA timezone (falls back to UTC). */
+export function GetLocalTimezone() {
+    try {
+        return Intl.DateTimeFormat().resolvedOptions().timeZone || 'UTC';
+    }
+    catch {
+        return 'UTC';
+    }
+}
+//# sourceMappingURL=routine-ui-helpers.js.map

package/dist/lib/routine-ui-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routine-ui-helpers.js","sourceRoot":"","sources":["../../src/lib/routine-ui-helpers.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Pure display / serialization helpers shared by the User Routines components.\n * No Angular or MJ runtime dependencies — unit-testable in isolation.\n */\nimport type { MJUserRoutineEntity } from '@memberjunction/core-entities';\n\n/** Chip variants aligned with the shared status-token vocabulary. */\nexport type RoutineChipVariant = 'success' | 'warning' | 'error' | 'info' | 'muted';\n\n/** Maps a routine lifecycle status to a chip variant. */\nexport function RoutineStatusVariant(status: MJUserRoutineEntity['Status']): RoutineChipVariant {\n    switch (status) {\n        case 'Active': return 'success';\n        case 'Paused': return 'warning';\n        case 'Disabled': return 'muted';\n        default: return 'muted';\n    }\n}\n\n/** Maps a run outcome status to a chip variant. */\nexport function RunStatusVariant(status: string | null | undefined): RoutineChipVariant {\n    switch (status) {\n        case 'Success': return 'success';\n        case 'Failed': return 'error';\n        case 'Running': return 'info';\n        case 'Skipped': return 'muted';\n        default: return 'muted';\n    }\n}\n\n/** Font Awesome icon class for a routine target type. */\nexport function TargetTypeIcon(targetType: MJUserRoutineEntity['TargetType']): string {\n    switch (targetType) {\n        case 'Agent': return 'fa-solid fa-robot';\n        case 'Action': return 'fa-solid fa-bolt';\n        case 'Prompt': return 'fa-solid fa-comment-dots';\n        default: return 'fa-solid fa-circle-question';\n    }\n}\n\n/**\n * Compact relative-time label (\"3m ago\", \"in 2h\", \"just now\"). Returns an empty\n * string for null input. `now` is injectable for tests.\n */\nexport function FormatRelativeTime(date: Date | null | undefined, now: Date = new Date()): string {\n    if (!date) {\n        return '';\n    }\n    const target = date instanceof Date ? date : new Date(date);\n    if (isNaN(target.getTime())) {\n        return '';\n    }\n    const diffMs = target.getTime() - now.getTime();\n    const absMs = Math.abs(diffMs);\n    const future = diffMs > 0;\n\n    if (absMs < 60_000) {\n        return future ? 'in <1m' : 'just now';\n    }\n    const units: Array<{ ms: number; label: string }> = [\n        { ms: 86_400_000 * 365, label: 'y' },\n        { ms: 86_400_000 * 30, label: 'mo' },\n        { ms: 86_400_000, label: 'd' },\n        { ms: 3_600_000, label: 'h' },\n        { ms: 60_000, label: 'm' },\n    ];\n    for (const unit of units) {\n        if (absMs >= unit.ms) {\n            const count = Math.floor(absMs / unit.ms);\n            return future ? `in ${count}${unit.label}` : `${count}${unit.label} ago`;\n        }\n    }\n    return future ? 'in <1m' : 'just now';\n}\n\n/** Duration between two timestamps as \"4s\", \"2m 10s\", \"1h 4m\". Empty when incomplete. */\nexport function FormatDuration(start: Date | null | undefined, end: Date | null | undefined): string {\n    if (!start || !end) {\n        return '';\n    }\n    const startMs = new Date(start).getTime();\n    const endMs = new Date(end).getTime();\n    if (isNaN(startMs) || isNaN(endMs) || endMs < startMs) {\n        return '';\n    }\n    const totalSeconds = Math.round((endMs - startMs) / 1000);\n    if (totalSeconds < 60) {\n        return `${totalSeconds}s`;\n    }\n    const totalMinutes = Math.floor(totalSeconds / 60);\n    if (totalMinutes < 60) {\n        return `${totalMinutes}m ${totalSeconds % 60}s`;\n    }\n    const hours = Math.floor(totalMinutes / 60);\n    return `${hours}h ${totalMinutes % 60}m`;\n}\n\n/**\n * Parses the RequestedSkillIDs JSON column into a string array. Tolerant: bad JSON,\n * non-array shapes, and non-string members all collapse to an empty/filtered array.\n */\nexport function ParseSkillIDs(raw: string | null | undefined): string[] {\n    if (!raw || raw.trim().length === 0) {\n        return [];\n    }\n    try {\n        const parsed: unknown = JSON.parse(raw);\n        if (!Array.isArray(parsed)) {\n            return [];\n        }\n        return parsed.filter((item): item is string => typeof item === 'string' && item.length > 0);\n    } catch {\n        return [];\n    }\n}\n\n/** Serializes a skill ID array to the JSON column value (null when empty). */\nexport function SerializeSkillIDs(ids: readonly string[]): string | null {\n    const clean = ids.filter((id) => id && id.length > 0);\n    return clean.length > 0 ? JSON.stringify(clean) : null;\n}\n\n/** Validates optional JSON text (StartingPayload). Blank is valid (stored as NULL). */\nexport function ValidateOptionalJson(text: string | null | undefined): { Valid: boolean; Error?: string } {\n    const trimmed = (text ?? '').trim();\n    if (trimmed.length === 0) {\n        return { Valid: true };\n    }\n    try {\n        JSON.parse(trimmed);\n        return { Valid: true };\n    } catch (e) {\n        return { Valid: false, Error: e instanceof Error ? e.message : 'Invalid JSON' };\n    }\n}\n\n/** Very light email shape check for external recipients (not RFC-complete on purpose). */\nexport function IsPlausibleEmail(email: string): boolean {\n    return /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(email.trim());\n}\n\n/**\n * Converts a Date to the string an `<input type=\"datetime-local\">` expects\n * (\"YYYY-MM-DDTHH:MM\", local time). Empty string for null.\n */\nexport function ToDateTimeLocal(date: Date | null | undefined): string {\n    if (!date) {\n        return '';\n    }\n    const d = date instanceof Date ? date : new Date(date);\n    if (isNaN(d.getTime())) {\n        return '';\n    }\n    const pad = (n: number) => n.toString().padStart(2, '0');\n    return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}T${pad(d.getHours())}:${pad(d.getMinutes())}`;\n}\n\n/** Parses a datetime-local string back to a Date (null for blank/invalid). */\nexport function FromDateTimeLocal(value: string | null | undefined): Date | null {\n    const trimmed = (value ?? '').trim();\n    if (!trimmed) {\n        return null;\n    }\n    const parsed = new Date(trimmed);\n    return isNaN(parsed.getTime()) ? null : parsed;\n}\n\n/**\n * The browser's IANA timezone list via Intl (ES2022), with a small static fallback for\n * older runtimes. The current zone is included by construction on modern browsers.\n */\nexport function GetTimezoneOptions(): string[] {\n    if (typeof Intl.supportedValuesOf === 'function') {\n        return Intl.supportedValuesOf('timeZone');\n    }\n    return [\n        'UTC',\n        'America/New_York', 'America/Chicago', 'America/Denver', 'America/Los_Angeles',\n        'Europe/London', 'Europe/Paris', 'Europe/Berlin',\n        'Asia/Tokyo', 'Asia/Shanghai', 'Asia/Kolkata',\n        'Australia/Sydney'\n    ];\n}\n\n/** The user's current IANA timezone (falls back to UTC). */\nexport function GetLocalTimezone(): string {\n    try {\n        return Intl.DateTimeFormat().resolvedOptions().timeZone || 'UTC';\n    } catch {\n        return 'UTC';\n    }\n}\n"]}

package/dist/lib/user-routines-command-center.component.d.ts

@@ -0,0 +1,88 @@
+import { EventEmitter } from '@angular/core';
+import { BaseAngularComponent } from '@memberjunction/ng-base-types';
+import { MJUserRoutineEntity } from '@memberjunction/core-entities';
+import { RoutineCounts, RoutineStatusFilter } from './my-routines-list.component';
+import { ConversationOpenedEventArgs, AfterRoutineCreatedEventArgs, AfterRoutineDeletedEventArgs, AfterRoutinePausedEventArgs, AfterRoutineRunNowEventArgs, BeforeRoutineCreatedEventArgs, BeforeRoutineDeletedEventArgs, BeforeRoutinePausedEventArgs, BeforeRoutineRunNowEventArgs, HistoryRecordOpenedEventArgs, RoutineSelectedEventArgs } from './user-routines-events';
+import * as i0 from "@angular/core";
+/** The command center's active internal view. */
+export type UserRoutinesView = 'list' | 'editor' | 'history';
+/**
+ * User Routines "command center" — the composite surface combining the routines list
+ * (default view), the create/edit form, and per-routine run history behind an internal
+ * tabbed navigation. This is the component hosts embed (Explorer full page, the
+ * slide-in, or any custom app); the individual pieces remain exported for bespoke
+ * layouts.
+ *
+ * All child events bubble here unchanged (including the cancelable Before/After
+ * pairs), so a consumer only ever wires this one component.
+ */
+export declare class UserRoutinesCommandCenterComponent extends BaseAngularComponent {
+    private cdr;
+    private list?;
+    private history?;
+    /** Render the built-in compact header (mark + tabs + list controls). Hosts with their own chrome set false. */
+    ShowHeader: boolean;
+    /** Show a close (X) affordance in the built-in header (used by the slide-in wrapper). */
+    ShowClose: boolean;
+    private _selectedRoutineID;
+    /**
+     * Deep-link style selection: setting a routine ID opens its history view
+     * (clearing it returns to the list). Used by Explorer's query-param round trip.
+     */
+    set SelectedRoutineID(value: string | null);
+    get SelectedRoutineID(): string | null;
+    /** Search text applied to the list view (hosts with their own chrome bind this). */
+    SearchText: string;
+    /** Status filter applied to the list view. */
+    StatusFilter: RoutineStatusFilter;
+    BeforeRoutineCreated: EventEmitter<BeforeRoutineCreatedEventArgs>;
+    AfterRoutineCreated: EventEmitter<AfterRoutineCreatedEventArgs>;
+    BeforeRoutinePaused: EventEmitter<BeforeRoutinePausedEventArgs>;
+    AfterRoutinePaused: EventEmitter<AfterRoutinePausedEventArgs>;
+    BeforeRoutineRunNow: EventEmitter<BeforeRoutineRunNowEventArgs>;
+    AfterRoutineRunNow: EventEmitter<AfterRoutineRunNowEventArgs>;
+    BeforeRoutineDeleted: EventEmitter<BeforeRoutineDeletedEventArgs>;
+    AfterRoutineDeleted: EventEmitter<AfterRoutineDeletedEventArgs>;
+    RoutineSelected: EventEmitter<RoutineSelectedEventArgs>;
+    HistoryRecordOpened: EventEmitter<HistoryRecordOpenedEventArgs>;
+    /** Re-emitted from the list — the routine's dedicated conversation was requested. */
+    ConversationOpened: EventEmitter<ConversationOpenedEventArgs>;
+    /** Loaded/filtered counts changed in the list view. */
+    CountsChanged: EventEmitter<RoutineCounts>;
+    /** The active internal view changed ('list' | 'editor' | 'history'). */
+    ViewChanged: EventEmitter<UserRoutinesView>;
+    /** The user clicked the built-in close affordance (slide-in wrapper handles it). */
+    CloseRequested: EventEmitter<void>;
+    /**
+     * The selected routine (history view) changed — `null` when returning to the list.
+     * Hosts using query-param round trips two-way bind [(SelectedRoutineID)].
+     */
+    SelectedRoutineIDChange: EventEmitter<string | null>;
+    ActiveView: UserRoutinesView;
+    /** Routine being edited (null = creating a new one). */
+    EditingRoutineID: string | null;
+    /** Routine whose history is open. */
+    HistoryRoutineID: string | null;
+    HistoryRoutineName: string | null;
+    TotalCount: number;
+    FilteredCount: number;
+    ShowList(): void;
+    ShowNewRoutine(): void;
+    ShowEditRoutine(routine: MJUserRoutineEntity | string): void;
+    ShowHistory(routine: MJUserRoutineEntity | string): void;
+    /** Force-refreshes the active view's data. */
+    Refresh(): Promise<void>;
+    OnCountsChanged(counts: RoutineCounts): void;
+    OnRoutineSelected(args: RoutineSelectedEventArgs): void;
+    OnHistoryRequested(routine: MJUserRoutineEntity): void;
+    OnEditRequested(routine: MJUserRoutineEntity): void;
+    OnEditorSaved(_routine: MJUserRoutineEntity): void;
+    OnEditorCancelled(): void;
+    OnSearchChange(value: string): void;
+    private setView;
+    private setSelectedRoutine;
+    private openHistoryById;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UserRoutinesCommandCenterComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<UserRoutinesCommandCenterComponent, "mj-user-routines-command-center", never, { "ShowHeader": { "alias": "ShowHeader"; "required": false; }; "ShowClose": { "alias": "ShowClose"; "required": false; }; "SelectedRoutineID": { "alias": "SelectedRoutineID"; "required": false; }; "SearchText": { "alias": "SearchText"; "required": false; }; "StatusFilter": { "alias": "StatusFilter"; "required": false; }; }, { "BeforeRoutineCreated": "BeforeRoutineCreated"; "AfterRoutineCreated": "AfterRoutineCreated"; "BeforeRoutinePaused": "BeforeRoutinePaused"; "AfterRoutinePaused": "AfterRoutinePaused"; "BeforeRoutineRunNow": "BeforeRoutineRunNow"; "AfterRoutineRunNow": "AfterRoutineRunNow"; "BeforeRoutineDeleted": "BeforeRoutineDeleted"; "AfterRoutineDeleted": "AfterRoutineDeleted"; "RoutineSelected": "RoutineSelected"; "HistoryRecordOpened": "HistoryRecordOpened"; "ConversationOpened": "ConversationOpened"; "CountsChanged": "CountsChanged"; "ViewChanged": "ViewChanged"; "CloseRequested": "CloseRequested"; "SelectedRoutineIDChange": "SelectedRoutineIDChange"; }, never, never, false, never>;
+}
+//# sourceMappingURL=user-routines-command-center.component.d.ts.map

package/dist/lib/user-routines-command-center.component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-routines-command-center.component.d.ts","sourceRoot":"","sources":["../../src/lib/user-routines-command-center.component.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,YAAY,EAAoC,MAAM,eAAe,CAAC;AAC7G,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAqB,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAA2B,aAAa,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAE3G,OAAO,EAAE,2BAA2B,EAChC,4BAA4B,EAC5B,4BAA4B,EAC5B,2BAA2B,EAC3B,2BAA2B,EAC3B,6BAA6B,EAC7B,6BAA6B,EAC7B,4BAA4B,EAC5B,4BAA4B,EAC5B,4BAA4B,EAC5B,wBAAwB,EAC3B,MAAM,wBAAwB,CAAC;;AAEhC,iDAAiD;AACjD,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE7D;;;;;;;;;GASG;AACH,qBAMa,kCAAmC,SAAQ,oBAAoB;IACxE,OAAO,CAAC,GAAG,CAA6B;IAErB,OAAO,CAAC,IAAI,CAAC,CAA0B;IACpC,OAAO,CAAC,OAAO,CAAC,CAA0B;IAKhE,+GAA+G;IACtG,UAAU,UAAQ;IAC3B,yFAAyF;IAChF,SAAS,UAAS;IAE3B,OAAO,CAAC,kBAAkB,CAAuB;IACjD;;;OAGG;IACH,IACW,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAShD;IACD,IAAW,iBAAiB,IAAI,MAAM,GAAG,IAAI,CAE5C;IAED,oFAAoF;IAC3E,UAAU,SAAM;IACzB,8CAA8C;IACrC,YAAY,EAAE,mBAAmB,CAAS;IAKzC,oBAAoB,8CAAqD;IACzE,mBAAmB,6CAAoD;IACvE,mBAAmB,6CAAoD;IACvE,kBAAkB,4CAAmD;IACrE,mBAAmB,6CAAoD;IACvE,kBAAkB,4CAAmD;IACrE,oBAAoB,8CAAqD;IACzE,mBAAmB,6CAAoD;IACvE,eAAe,yCAAgD;IAC/D,mBAAmB,6CAAoD;IACjF,qFAAqF;IAC3E,kBAAkB,4CAAmD;IAC/E,uDAAuD;IAC7C,aAAa,8BAAqC;IAC5D,wEAAwE;IAC9D,WAAW,iCAAwC;IAC7D,oFAAoF;IAC1E,cAAc,qBAA4B;IACpD;;;OAGG;IACO,uBAAuB,8BAAqC;IAK/D,UAAU,EAAE,gBAAgB,CAAU;IAC7C,wDAAwD;IACjD,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC9C,qCAAqC;IAC9B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAQ;IACvC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAQ;IACzC,UAAU,SAAK;IACf,aAAa,SAAK;IAKlB,QAAQ,IAAI,IAAI;IAKhB,cAAc,IAAI,IAAI;IAKtB,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,GAAG,IAAI;IAK5D,WAAW,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,GAAG,IAAI;IAW/D,8CAA8C;IACjC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAW9B,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAO5C,iBAAiB,CAAC,IAAI,EAAE,wBAAwB,GAAG,IAAI;IAIvD,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAItD,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAInD,aAAa,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAIlD,iBAAiB,IAAI,IAAI;IAIzB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQ1C,OAAO,CAAC,OAAO;IAQf,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,eAAe;yCAzKd,kCAAkC;2CAAlC,kCAAkC;CAiL9C"}