@happyvertical/smrt-support 0.39.2

package/dist/models/support-policy.d.ts

@@ -0,0 +1,84 @@
+import { SmrtCollection, SmrtObject } from '@happyvertical/smrt-core';
+/**
+ * Conservative defaults applied when no SupportPolicy row matches: the AI
+ * acknowledges, classifies, and answers, but never closes a case or executes
+ * tools until a policy explicitly enables it. Handoff triggers are always
+ * active regardless of policy.
+ */
+export declare const DEFAULT_SUPPORT_POLICY: {
+    readonly autoAcknowledge: true;
+    readonly autoClassify: true;
+    readonly autoAnswer: true;
+    readonly autoTroubleshoot: false;
+    readonly autoResolve: false;
+    readonly autoResolveMaxSeverity: "";
+    readonly confidenceThreshold: 0.7;
+    readonly maxAutoAttempts: 1;
+    readonly autoSendEmailReplies: false;
+    readonly sensitiveCategories: string[];
+    readonly allowedTools: string[];
+};
+export declare class SupportPolicy extends SmrtObject {
+    tenantId: string | null;
+    /** Policy name, unique per tenant (`conflictColumns`). */
+    name: string;
+    /** Scope: applies to cases under this plan (null = any plan). */
+    planId: string | null;
+    /** Scope: applies to cases for this app-defined project (null = any). */
+    projectId: string | null;
+    enabled: boolean;
+    /** Immediately acknowledge new inbound cases. */
+    autoAcknowledge: boolean;
+    /** Classify severity/category/sensitivity on intake. */
+    autoClassify: boolean;
+    /** Post an automated answer using scoped knowledge. */
+    autoAnswer: boolean;
+    /** Run tool-executing troubleshooting (gated OFF by default). */
+    autoTroubleshoot: boolean;
+    /** Allow the AI to resolve (close out) low-risk cases (OFF by default). */
+    autoResolve: boolean;
+    /**
+     * Highest severity the AI may auto-resolve (e.g. `sev4` = questions only).
+     * Empty means "no severity is eligible" even when `autoResolve` is true.
+     */
+    autoResolveMaxSeverity: string;
+    /**
+     * Confidence floor for automated answers/resolutions; below it the workflow
+     * triggers a `low_confidence` Human Handoff.
+     */
+    confidenceThreshold: number;
+    /** Max automated resolution attempts before a `failed_resolution` handoff. */
+    maxAutoAttempts: number;
+    /** Whether automated email replies may be sent (vs drafted) — OFF default. */
+    autoSendEmailReplies: boolean;
+    /**
+     * Categories considered sensitive: classification into one of these always
+     * triggers a Human Handoff (FR-28b). JSON array of category keys.
+     */
+    sensitiveCategories: string;
+    /** Tool ids the troubleshooting phase may execute. JSON array, fail-closed. */
+    allowedTools: string;
+    metadata: string;
+    getSensitiveCategories(): string[];
+    setSensitiveCategories(categories: string[]): void;
+    getAllowedTools(): string[];
+    setAllowedTools(tools: string[]): void;
+    getMetadata(): Record<string, unknown>;
+    setMetadata(value: Record<string, unknown>): void;
+    /** Specificity rank for resolution: exact scope wins over partial. */
+    scopeRank(): number;
+}
+export declare class SupportPolicyCollection extends SmrtCollection<SupportPolicy> {
+    static readonly _itemClass: typeof SupportPolicy;
+    /**
+     * Resolve the effective policy for a case scope, most-specific-wins.
+     * Returns `null` when no enabled policy matches (callers then apply
+     * {@link DEFAULT_SUPPORT_POLICY}).
+     */
+    resolveForScope(options: {
+        planId?: string | null;
+        projectId?: string | null;
+    }): Promise<SupportPolicy | null>;
+}
+export default SupportPolicy;
+//# sourceMappingURL=support-policy.d.ts.map

package/dist/models/support-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"support-policy.d.ts","sourceRoot":"","sources":["../../src/models/support-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAGL,cAAc,EACd,UAAU,EAEX,MAAM,0BAA0B,CAAC;AAIlC;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;kCAUN,MAAM,EAAE;2BACf,MAAM,EAAE;CACpB,CAAC;AAEX,qBAQa,aAAc,SAAQ,UAAU;IAE3C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE/B,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAM;IAElB,iEAAiE;IAEjE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE7B,yEAAyE;IAEzE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAQ;IAGhC,OAAO,EAAE,OAAO,CAAQ;IAExB,iDAAiD;IAEjD,eAAe,EAAE,OAAO,CAAQ;IAEhC,wDAAwD;IAExD,YAAY,EAAE,OAAO,CAAQ;IAE7B,uDAAuD;IAEvD,UAAU,EAAE,OAAO,CAAQ;IAE3B,iEAAiE;IAEjE,gBAAgB,EAAE,OAAO,CAAS;IAElC,2EAA2E;IAE3E,WAAW,EAAE,OAAO,CAAS;IAE7B;;;OAGG;IAEH,sBAAsB,EAAE,MAAM,CAAM;IAEpC;;;OAGG;IACH,mBAAmB,EAAE,MAAM,CAAO;IAElC,8EAA8E;IAC9E,eAAe,EAAE,MAAM,CAAK;IAE5B,8EAA8E;IAE9E,oBAAoB,EAAE,OAAO,CAAS;IAEtC;;;OAGG;IAEH,mBAAmB,EAAE,MAAM,CAAQ;IAEnC,+EAA+E;IAE/E,YAAY,EAAE,MAAM,CAAQ;IAG5B,QAAQ,EAAE,MAAM,CAAQ;IAExB,sBAAsB,IAAI,MAAM,EAAE;IAIlC,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI;IAIlD,eAAe,IAAI,MAAM,EAAE;IAI3B,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAItC,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAItC,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIjD,sEAAsE;IACtE,SAAS,IAAI,MAAM;CAMpB;AAED,qBAAa,uBAAwB,SAAQ,cAAc,CAAC,aAAa,CAAC;IACxE,MAAM,CAAC,QAAQ,CAAC,UAAU,uBAAiB;IAE3C;;;;OAIG;IACG,eAAe,CAAC,OAAO,EAAE;QAC7B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC3B,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;CAYlC;AAED,eAAe,aAAa,CAAC"}

package/dist/models/support-service-target.d.ts

@@ -0,0 +1,90 @@
+import { SmrtCollection, SmrtObject } from '@happyvertical/smrt-core';
+import { ServiceTargetStatus, ServiceTargetType, SupportEscalationReason } from '../types.js';
+/** Outcome of one {@link SupportServiceTarget.checkAndEscalate} delivery. */
+export interface CheckAndEscalateResult {
+    outcome: 'breached' | 'escalated' | 'rescheduled' | 'noop' | 'missing';
+}
+export declare class SupportServiceTarget extends SmrtObject {
+    tenantId: string | null;
+    caseId: string;
+    targetType: ServiceTargetType;
+    /**
+     * Recurrence cycle for repeating clocks (`update` restarts after each
+     * update). One-shot clocks stay at cycle 0.
+     */
+    cycle: number;
+    /** Severity key the minutes were derived from (audit). */
+    severity: string;
+    /** Configured clock length in covered minutes. */
+    baseMinutes: number;
+    /** When the clock started running. */
+    startedAt: Date;
+    /** Current deadline, in wall-clock time (recomputed on pause/resume). */
+    dueAt: Date;
+    status: ServiceTargetStatus;
+    /** Set while the clock is paused (plan pause rules). */
+    pausedAt: Date | null;
+    /** Accumulated paused time, excluded from the clock. */
+    pausedTotalSeconds: number;
+    satisfiedAt: Date | null;
+    breachedAt: Date | null;
+    cancelledAt: Date | null;
+    /** One-shot `_smrt_jobs` id scheduled for `dueAt` (cancel on satisfy). */
+    escalationJobId: string;
+    metadata: string;
+    getMetadata(): Record<string, unknown>;
+    setMetadata(value: Record<string, unknown>): void;
+    isRunning(): boolean;
+    /**
+     * One-shot escalation job entry point, delivered at-least-once by the
+     * jobs runner at `dueAt` (and again for delayed policy steps). Reloads its
+     * own persisted state first, so stale deliveries are harmless:
+     *
+     * - not `pending` and no due pending-escalation marker → no-op (already
+     *   satisfied/cancelled/paused, or an already-breached clock without a due
+     *   follow-up step);
+     * - `pending` with `dueAt` in the future → no-op (the clock was
+     *   rescheduled after this job was enqueued);
+     * - `pending` and overdue → mark breached and escalate through the plan's
+     *   escalation policy;
+     * - `breached` with a due pending-escalation marker → continue with the
+     *   next policy step.
+     *
+     * The engine is imported dynamically to avoid a static model → service
+     * cycle. `args.at` (ISO string or `Date`) pins "now" for deterministic
+     * tests; the runner passes no args, so production uses wall-clock time.
+     */
+    checkAndEscalate(args?: Record<string, unknown>, _context?: unknown): Promise<CheckAndEscalateResult>;
+}
+export declare class SupportServiceTargetCollection extends SmrtCollection<SupportServiceTarget> {
+    static readonly _itemClass: typeof SupportServiceTarget;
+    forCase(caseId: string): Promise<SupportServiceTarget[]>;
+    /** Active clock of a type on a case (highest cycle wins). */
+    activeTarget(caseId: string, targetType: ServiceTargetType): Promise<SupportServiceTarget | null>;
+}
+export declare class SupportEscalation extends SmrtObject {
+    tenantId: string | null;
+    caseId: string;
+    /** Escalation level applied (1-based, follows the plan's policy steps). */
+    level: number;
+    reason: SupportEscalationReason;
+    /** Breached/at-risk target that triggered this, when applicable. */
+    targetId: string | null;
+    targetType: string;
+    /** Escalation action taken: `notify` | `reassign`. */
+    action: string;
+    fromSpecialistId: string | null;
+    toSpecialistId: string | null;
+    /** Profiles notified (JSON array of profile ids). */
+    notifiedProfileIds: string;
+    occurredAt: Date;
+    note: string;
+    getNotifiedProfileIds(): string[];
+    setNotifiedProfileIds(ids: string[]): void;
+}
+export declare class SupportEscalationCollection extends SmrtCollection<SupportEscalation> {
+    static readonly _itemClass: typeof SupportEscalation;
+    forCase(caseId: string): Promise<SupportEscalation[]>;
+}
+export default SupportServiceTarget;
+//# sourceMappingURL=support-service-target.d.ts.map

package/dist/models/support-service-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"support-service-target.d.ts","sourceRoot":"","sources":["../../src/models/support-service-target.ts"],"names":[],"mappings":"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"}

package/dist/models/support-settlement.d.ts

@@ -0,0 +1,58 @@
+import { SmrtCollection, SmrtObject } from '@happyvertical/smrt-core';
+import { SupportSettlementStatus } from '../types.js';
+export declare class SupportCharge extends SmrtObject {
+    tenantId: string | null;
+    timeEntryId: string;
+    caseId: string | null;
+    /** Plan the pricing derived from (null = no plan; zero-amount charge). */
+    planId: string | null;
+    /** Client charge amount for the billable time. */
+    amount: number;
+    currency: string;
+    /** Seconds priced at the metered rate (after included-time consumption). */
+    billableSeconds: number;
+    /** Seconds absorbed by the plan's included support time. */
+    includedSecondsApplied: number;
+    /**
+     * JSON snapshot of the pricing terms used: hourly rate, rate source
+     * (`overage` | `on_call` | `none`), plan key, included-time state,
+     * derivation timestamp. Never rewritten by later plan edits.
+     */
+    rateSnapshot: string;
+    status: SupportSettlementStatus;
+    finalizedAt: Date | null;
+    metadata: string;
+    getRateSnapshot(): Record<string, unknown>;
+    setRateSnapshot(value: Record<string, unknown>): void;
+}
+export declare class SupportChargeCollection extends SmrtCollection<SupportCharge> {
+    static readonly _itemClass: typeof SupportCharge;
+    forTimeEntry(timeEntryId: string): Promise<SupportCharge | null>;
+    forCase(caseId: string): Promise<SupportCharge[]>;
+}
+export declare class SupportCompensation extends SmrtObject {
+    tenantId: string | null;
+    timeEntryId: string;
+    specialistId: string | null;
+    /** Compensation plan the earning derived from (null = no plan resolved). */
+    compensationPlanId: string | null;
+    /** Provider earning amount for the payable time. */
+    amount: number;
+    currency: string;
+    /** Seconds compensated. */
+    payableSeconds: number;
+    /** JSON snapshot of the earning terms used at derivation time. */
+    rateSnapshot: string;
+    status: SupportSettlementStatus;
+    finalizedAt: Date | null;
+    metadata: string;
+    getRateSnapshot(): Record<string, unknown>;
+    setRateSnapshot(value: Record<string, unknown>): void;
+}
+export declare class SupportCompensationCollection extends SmrtCollection<SupportCompensation> {
+    static readonly _itemClass: typeof SupportCompensation;
+    forTimeEntry(timeEntryId: string): Promise<SupportCompensation | null>;
+    forSpecialist(specialistId: string): Promise<SupportCompensation[]>;
+}
+export default SupportCharge;
+//# sourceMappingURL=support-settlement.d.ts.map

package/dist/models/support-settlement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"support-settlement.d.ts","sourceRoot":"","sources":["../../src/models/support-settlement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAGL,cAAc,EACd,UAAU,EAEX,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAkB,KAAK,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAE3E,qBAQa,aAAc,SAAQ,UAAU;IAE3C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAG/B,WAAW,EAAE,MAAM,CAAM;IAGzB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE7B,0EAA0E;IAE1E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE7B,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAO;IAGrB,QAAQ,EAAE,MAAM,CAAS;IAEzB,4EAA4E;IAC5E,eAAe,EAAE,MAAM,CAAK;IAE5B,4DAA4D;IAC5D,sBAAsB,EAAE,MAAM,CAAK;IAEnC;;;;OAIG;IAEH,YAAY,EAAE,MAAM,CAAQ;IAG5B,MAAM,EAAE,uBAAuB,CAAa;IAE5C,WAAW,EAAE,IAAI,GAAG,IAAI,CAAQ;IAGhC,QAAQ,EAAE,MAAM,CAAQ;IAExB,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI1C,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAGtD;AAED,qBAAa,uBAAwB,SAAQ,cAAc,CAAC,aAAa,CAAC;IACxE,MAAM,CAAC,QAAQ,CAAC,UAAU,uBAAiB;IAErC,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAKhE,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;CAGxD;AAED,qBAQa,mBAAoB,SAAQ,UAAU;IAEjD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAG/B,WAAW,EAAE,MAAM,CAAM;IAGzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEnC,4EAA4E;IAE5E,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEzC,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAO;IAGrB,QAAQ,EAAE,MAAM,CAAS;IAEzB,2BAA2B;IAC3B,cAAc,EAAE,MAAM,CAAK;IAE3B,kEAAkE;IAElE,YAAY,EAAE,MAAM,CAAQ;IAG5B,MAAM,EAAE,uBAAuB,CAAa;IAE5C,WAAW,EAAE,IAAI,GAAG,IAAI,CAAQ;IAGhC,QAAQ,EAAE,MAAM,CAAQ;IAExB,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI1C,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAGtD;AAED,qBAAa,6BAA8B,SAAQ,cAAc,CAAC,mBAAmB,CAAC;IACpF,MAAM,CAAC,QAAQ,CAAC,UAAU,6BAAuB;IAE3C,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAKtE,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;CAG1E;AAED,eAAe,aAAa,CAAC"}

package/dist/models/support-specialist.d.ts

@@ -0,0 +1,71 @@
+import { SmrtCollection, SmrtObject } from '@happyvertical/smrt-core';
+import { SupportAvailabilityKind, SupportQualificationLevel, SupportSpecialistStatus } from '../types.js';
+export declare class SupportSpecialist extends SmrtObject {
+    tenantId: string | null;
+    /** The Participant (Person profile) this specialist role belongs to. */
+    profileId: string;
+    /** Display name for queues/routing rationale (denormalized from Profile). */
+    displayName: string;
+    status: SupportSpecialistStatus;
+    /** Languages the specialist supports (JSON array of BCP-47-ish codes). */
+    languages: string;
+    /** IANA timezone the weekly availability windows are expressed in. */
+    timezone: string;
+    /** Routing workload cap: open cases beyond this exclude the specialist. */
+    maxConcurrentCases: number;
+    /** Tie-break priority for on-call ranking (higher = preferred). */
+    onCallPriority: number;
+    notes: string;
+    metadata: string;
+    getLanguages(): string[];
+    setLanguages(languages: string[]): void;
+    getMetadata(): Record<string, unknown>;
+    setMetadata(value: Record<string, unknown>): void;
+    isActive(): boolean;
+}
+export declare class SupportSpecialistCollection extends SmrtCollection<SupportSpecialist> {
+    static readonly _itemClass: typeof SupportSpecialist;
+    findActive(): Promise<SupportSpecialist[]>;
+    byProfile(profileId: string): Promise<SupportSpecialist | null>;
+}
+export declare class SupportQualification extends SmrtObject {
+    tenantId: string | null;
+    specialistId: string;
+    /** App-defined Project this qualification covers. */
+    projectId: string;
+    level: SupportQualificationLevel;
+    /** Effective-dating: null bounds mean open-ended. */
+    effectiveFrom: Date | null;
+    effectiveTo: Date | null;
+    grantedByProfileId: string | null;
+    notes: string;
+    /** Whether the qualification is effective at the given instant. */
+    isEffectiveAt(at?: Date): boolean;
+}
+export declare class SupportQualificationCollection extends SmrtCollection<SupportQualification> {
+    static readonly _itemClass: typeof SupportQualification;
+    forSpecialist(specialistId: string): Promise<SupportQualification[]>;
+    forProject(projectId: string): Promise<SupportQualification[]>;
+}
+export declare class SupportAvailability extends SmrtObject {
+    tenantId: string | null;
+    specialistId: string;
+    kind: SupportAvailabilityKind;
+    /** Weekly windows: 0 = Sunday … 6 = Saturday. Null for span kinds. */
+    weekday: number | null;
+    /** Weekly windows: minutes from midnight, inclusive start. */
+    startMinute: number;
+    /** Weekly windows: minutes from midnight, exclusive end. */
+    endMinute: number;
+    /** Span kinds (`on_call`, `time_off`): absolute start. */
+    startsAt: Date | null;
+    /** Span kinds (`on_call`, `time_off`): absolute end. */
+    endsAt: Date | null;
+    notes: string;
+}
+export declare class SupportAvailabilityCollection extends SmrtCollection<SupportAvailability> {
+    static readonly _itemClass: typeof SupportAvailability;
+    forSpecialist(specialistId: string): Promise<SupportAvailability[]>;
+}
+export default SupportSpecialist;
+//# sourceMappingURL=support-specialist.d.ts.map

package/dist/models/support-specialist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"support-specialist.d.ts","sourceRoot":"","sources":["../../src/models/support-specialist.ts"],"names":[],"mappings":"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"}

package/dist/models/support-work-link.d.ts

@@ -0,0 +1,31 @@
+import { SmrtCollection, SmrtObject } from '@happyvertical/smrt-core';
+import { SupportWorkLinkKind } from '../types.js';
+export declare class SupportWorkLink extends SmrtObject {
+    tenantId: string | null;
+    caseId: string;
+    linkKind: SupportWorkLinkKind;
+    /**
+     * Qualified class of the linked work item, e.g.
+     * `@happyvertical/smrt-projects:Issue`.
+     */
+    targetType: string;
+    targetId: string;
+    /** Display label for the case timeline (e.g. `repo#123: fix login`). */
+    targetLabel: string;
+    externalUrl: string;
+    /**
+     * Status echo reported back from the owning domain (`open`,
+     * `in_progress`, `done`, …). Informational only.
+     */
+    status: string;
+    lastStatusAt: Date | null;
+    metadata: string;
+    getMetadata(): Record<string, unknown>;
+    setMetadata(value: Record<string, unknown>): void;
+}
+export declare class SupportWorkLinkCollection extends SmrtCollection<SupportWorkLink> {
+    static readonly _itemClass: typeof SupportWorkLink;
+    forCase(caseId: string): Promise<SupportWorkLink[]>;
+}
+export default SupportWorkLink;
+//# sourceMappingURL=support-work-link.d.ts.map

package/dist/models/support-work-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"support-work-link.d.ts","sourceRoot":"","sources":["../../src/models/support-work-link.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAGL,cAAc,EACd,UAAU,EAEX,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAkB,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvE,qBAQa,eAAgB,SAAQ,UAAU;IAE7C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAG/B,MAAM,EAAE,MAAM,CAAM;IAGpB,QAAQ,EAAE,mBAAmB,CAAuB;IAEpD;;;OAGG;IAEH,UAAU,EAAE,MAAM,CAAM;IAGxB,QAAQ,EAAE,MAAM,CAAM;IAEtB,wEAAwE;IAExE,WAAW,EAAE,MAAM,CAAM;IAGzB,WAAW,EAAE,MAAM,CAAM;IAEzB;;;OAGG;IAEH,MAAM,EAAE,MAAM,CAAU;IAExB,YAAY,EAAE,IAAI,GAAG,IAAI,CAAQ;IAGjC,QAAQ,EAAE,MAAM,CAAQ;IAExB,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAItC,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAGlD;AAED,qBAAa,yBAA0B,SAAQ,cAAc,CAAC,eAAe,CAAC;IAC5E,MAAM,CAAC,QAAQ,CAAC,UAAU,yBAAmB;IAEvC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CAG1D;AAED,eAAe,eAAe,CAAC"}

package/dist/permissions.d.ts

@@ -0,0 +1,32 @@
+import { PermissionDefinition } from '@happyvertical/smrt-users';
+/** Authorizes manual case reassignment overriding automatic routing. */
+export declare const REASSIGN_CASE_PERMISSION = "support.reassign-case";
+/** Authorizes operator approval/rejection of Service Time Entries. */
+export declare const APPROVE_TIME_ENTRY_PERMISSION = "support.approve-time-entry";
+/** Authorizes plan administration (support + compensation plans). */
+export declare const MANAGE_PLANS_PERMISSION = "support.manage-plans";
+export declare const SUPPORT_PERMISSION_DEFS: PermissionDefinition[];
+/**
+ * An actor whose authority is expressed as held permission slugs. Minimal on
+ * purpose — the gate depends on the permission model only (personas idiom).
+ */
+export interface SupportPrincipal {
+    /** Stable id recorded as the acting reviewer/assigner. */
+    readonly id?: string;
+    /** Tenant the authority was resolved for (cross-tenant acts are refused). */
+    readonly tenantId?: string;
+    can(slug: string): boolean;
+}
+/** Build a {@link SupportPrincipal} from explicit granted slugs. */
+export declare function supportPrincipalFromPermissions(permissions: Iterable<string>, options?: {
+    id?: string;
+    tenantId?: string;
+}): SupportPrincipal;
+/** Register the support permissions (returns an unregister fn for tests). */
+export declare function registerSupportPermissions(): () => void;
+/**
+ * Register the support permissions once per process. Called as a package
+ * entry side effect so any consumer sees the slugs in the catalog.
+ */
+export declare function ensureSupportPermissionsRegistered(): void;
+//# sourceMappingURL=permissions.d.ts.map

package/dist/permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../src/permissions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,KAAK,oBAAoB,EAE1B,MAAM,2BAA2B,CAAC;AAEnC,wEAAwE;AACxE,eAAO,MAAM,wBAAwB,0BAA0B,CAAC;AAEhE,sEAAsE;AACtE,eAAO,MAAM,6BAA6B,+BAA+B,CAAC;AAE1E,qEAAqE;AACrE,eAAO,MAAM,uBAAuB,yBAAyB,CAAC;AAE9D,eAAO,MAAM,uBAAuB,EAAE,oBAAoB,EAsBzD,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAC5B;AAED,oEAAoE;AACpE,wBAAgB,+BAA+B,CAC7C,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,EAC7B,OAAO,GAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/C,gBAAgB,CAOlB;AAID,6EAA6E;AAC7E,wBAAgB,0BAA0B,IAAI,MAAM,IAAI,CAEvD;AAED;;;GAGG;AACH,wBAAgB,kCAAkC,IAAI,IAAI,CAMzD"}

package/dist/services/coverage-calendar.d.ts

@@ -0,0 +1,53 @@
+import { CoverageWindow } from '../types.js';
+/** The coverage terms a Service Target clock runs against. */
+export interface CoverageCalendar {
+    /** Weekly coverage windows; empty means 24×7 coverage. */
+    windows: CoverageWindow[];
+    /** Holiday dates excluded from coverage (`YYYY-MM-DD`). */
+    holidays: string[];
+    /** IANA timezone the windows and holidays are expressed in. */
+    timezone: string;
+}
+/** Wall-clock projection of a UTC instant in a target timezone. */
+export interface ZonedParts {
+    /** Calendar year in the target timezone. */
+    year: number;
+    /** Calendar month in the target timezone (1–12). */
+    month: number;
+    /** Calendar day of month in the target timezone (1–31). */
+    day: number;
+    /** 0 = Sunday … 6 = Saturday (matches {@link CoverageWindow} docs). */
+    weekday: number;
+    /** Minutes from local midnight (0–1439). */
+    minuteOfDay: number;
+    /** `YYYY-MM-DD` date key in the target timezone (holiday comparisons). */
+    dateKey: string;
+}
+/**
+ * Hard ceiling on how many calendar days {@link addCoveredMinutes} will walk
+ * forward looking for coverage before failing loudly (a plan whose calendar
+ * never covers anything would otherwise loop forever).
+ */
+export declare const MAX_COVERAGE_SCAN_DAYS = 400;
+/**
+ * Project a UTC instant onto a timezone's wall clock via
+ * `Intl.DateTimeFormat#formatToParts`. Throws a `RangeError` for an invalid
+ * IANA timezone name (surfacing plan misconfiguration immediately).
+ */
+export declare function zonedParts(date: Date, timeZone: string): ZonedParts;
+/**
+ * Covered minutes between two instants (fractional; `0` when `to <= from`).
+ *
+ * Walks forward day by day through the calendar timezone, summing the overlap
+ * of `[from, to)` with each day's covered spans.
+ */
+export declare function coveredMinutesBetween(calendar: CoverageCalendar, from: Date, to: Date): number;
+/**
+ * The instant at which `minutes` of covered time have elapsed from `from` —
+ * the Service Target due-time computation. Walks forward day by day through
+ * coverage windows, skipping holidays; throws a descriptive error after
+ * {@link MAX_COVERAGE_SCAN_DAYS} days without accumulating enough coverage
+ * (an effectively-empty calendar).
+ */
+export declare function addCoveredMinutes(calendar: CoverageCalendar, from: Date, minutes: number): Date;
+//# sourceMappingURL=coverage-calendar.d.ts.map

package/dist/services/coverage-calendar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage-calendar.d.ts","sourceRoot":"","sources":["../../src/services/coverage-calendar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,8DAA8D;AAC9D,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,mEAAmE;AACnE,MAAM,WAAW,UAAU;IACzB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,GAAG,EAAE,MAAM,CAAC;IACZ,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAsC1C;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CAmBnE;AAiID;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,gBAAgB,EAC1B,IAAI,EAAE,IAAI,EACV,EAAE,EAAE,IAAI,GACP,MAAM,CAgCR;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,gBAAgB,EAC1B,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,MAAM,GACd,IAAI,CAwCN"}

package/dist/services/human-handoff-service.d.ts

@@ -0,0 +1,113 @@
+import { SmrtObjectOptions } from '@happyvertical/smrt-core';
+import { SupportAiRunCollection } from '../models/support-ai-run.js';
+import { SupportCase } from '../models/support-case.js';
+import { HumanHandoffTrigger } from '../types.js';
+import { SupportCaseService } from './support-case-service.js';
+/** One compact timeline entry inside a {@link HandoffContextPackage}. */
+export interface HandoffTimelineItem {
+    kind: 'interaction' | 'event';
+    /** ISO-8601 timestamp (the package is embedded in a JSON event payload). */
+    occurredAt: string;
+    actorKind: string;
+    summary: string;
+    /** Interaction body — the Client's own words travel with the handoff. */
+    body?: string;
+}
+/** One compact AI-run entry inside a {@link HandoffContextPackage}. */
+export interface HandoffAiRunSummary {
+    phase: string;
+    outcome: string;
+    confidence: number | null;
+    classification: Record<string, unknown>;
+    error: string | null;
+}
+/**
+ * The lossless context a Human Handoff transfers (FR-28b): the case's current
+ * state plus the merged timeline and every prior automated-work audit row.
+ * This is what the assigned Support Specialist receives — the Client never
+ * repeats themselves.
+ */
+export interface HandoffContextPackage {
+    caseNumber: string;
+    subject: string;
+    status: string;
+    severity: string;
+    category: string;
+    clientProfileId: string | null;
+    projectId: string | null;
+    planId: string | null;
+    timeline: HandoffTimelineItem[];
+    aiRuns: HandoffAiRunSummary[];
+}
+/**
+ * The routing seam (#1929): pick the Support Specialist for a handed-off
+ * case. Return `null` to leave the case in the queue for manual assignment.
+ */
+export type SpecialistRouter = (supportCase: SupportCase, context: {
+    trigger: HumanHandoffTrigger;
+}) => Promise<{
+    specialistId: string;
+    rationale?: Record<string, unknown>;
+} | null>;
+/** Options for {@link HumanHandoffService.create}. */
+export interface HumanHandoffServiceOptions extends SmrtObjectOptions {
+    /** Routing seam; omitted → handed-off cases queue for manual assignment. */
+    assignSpecialist?: SpecialistRouter;
+}
+/** Input for one {@link HumanHandoffService.handoff} call. */
+export interface HumanHandoffInput {
+    trigger: HumanHandoffTrigger;
+    /** Free-form context for the audit event (why the trigger fired). */
+    note?: string;
+    /** The requesting Client profile, for `client_request` triggers. */
+    requestedByProfileId?: string | null;
+}
+/** Result of one {@link HumanHandoffService.handoff} call. */
+export interface HumanHandoffResult {
+    supportCase: SupportCase;
+    /** True when an earlier handoff was still active (no-repeat guarantee). */
+    alreadyActive: boolean;
+}
+/**
+ * The Human Handoff engine. Construct with {@link HumanHandoffService.create}.
+ */
+export declare class HumanHandoffService {
+    readonly caseService: SupportCaseService;
+    readonly aiRuns: SupportAiRunCollection;
+    private readonly assignSpecialist?;
+    protected constructor(deps: {
+        caseService: SupportCaseService;
+        aiRuns: SupportAiRunCollection;
+        assignSpecialist?: SpecialistRouter;
+    });
+    static create(options: HumanHandoffServiceOptions): Promise<HumanHandoffService>;
+    /**
+     * Assemble the lossless context package for a case: current state, the
+     * merged interaction/event timeline, and every prior AI run (FR-28b).
+     */
+    buildContextPackage(caseId: string): Promise<HandoffContextPackage>;
+    /**
+     * Hand the case to a human: enforce the no-repeat guarantee, stamp
+     * `metadata.activeHandoff`, record the `handoff` audit event carrying the
+     * full context package, then route via the `assignSpecialist` seam (or
+     * queue the case as `triaged` when unrouted).
+     */
+    handoff(caseRef: SupportCase | string, input: HumanHandoffInput): Promise<HumanHandoffResult>;
+    /**
+     * Clear the active-handoff flag so a later trigger can hand off again.
+     * Apps call this when the handoff concludes (assignment accepted or the
+     * case resolves); a resolve-then-reopen also invalidates the flag
+     * automatically inside {@link handoff}.
+     */
+    releaseHandoff(caseRef: SupportCase | string): Promise<SupportCase>;
+    /**
+     * Whether a handoff is still pending on the case. A flag survives only
+     * while the case stays open; a resolve-and-reopen since the flag was set
+     * makes it stale (the new conversation may hand off afresh).
+     */
+    private isHandoffActive;
+    /** The persisted id of a saved case. */
+    private caseIdOf;
+}
+export default HumanHandoffService;
+//# sourceMappingURL=human-handoff-service.d.ts.map

package/dist/services/human-handoff-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"human-handoff-service.d.ts","sourceRoot":"","sources":["../../src/services/human-handoff-service.ts"],"names":[],"mappings":"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"}

package/dist/services/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Service barrel for `@happyvertical/smrt-support`.
+ */
+export { addCoveredMinutes, type CoverageCalendar, coveredMinutesBetween, MAX_COVERAGE_SCAN_DAYS, type ZonedParts, zonedParts, } from './coverage-calendar.js';
+export { type HandoffAiRunSummary, type HandoffContextPackage, type HandoffTimelineItem, type HumanHandoffInput, type HumanHandoffResult, HumanHandoffService, type HumanHandoffServiceOptions, type SpecialistRouter, } from './human-handoff-service.js';
+export { KeyedMutex } from './keyed-mutex.js';
+export { DEFAULT_SEVERITY_KEY, ESCALATION_JOB_PRIORITY, type ResolvedTargetPlanTerms, ServiceTargetEngine, type ServiceTargetEngineOptions, SUPPORT_JOB_QUEUE, } from './service-target-engine.js';
+export { type RecordServiceTimeEntryInput, ServiceTimeEntryService, type ServiceTimeEntryServiceOptions, type SubmitServiceTimeEntryInput, } from './service-time-entry-service.js';
+export { createDefaultAiBoundary, createNoopKnowledgeProvider, type KnowledgeSnippet, type SupportAiAnswerResult, type SupportAiBoundary, type SupportAiClassifyResult, SupportAiWorkflow, type SupportAiWorkflowOptions, type SupportHandoffNotice, type SupportKnowledgeProvider, severityRank, } from './support-ai-workflow.js';
+export { type CaseActor, type CaseTimelineItem, type OpenCaseInput, type RecordInteractionInput, SupportCaseService, } from './support-case-service.js';
+export { CHAT_MESSAGE_SOURCE_TYPE, CHAT_ROOM_TARGET_TYPE, EMAIL_ACCOUNT_TARGET_TYPE, EMAIL_SOURCE_TYPE, type InboundChatMessage, type InboundEmail, type IntakeResult, registerSupportIntake, SUPPORT_INTAKE_INTERCEPTOR, type SupportIntakeOptions, SupportIntakeService, } from './support-intake-service.js';
+export { type PlanAdminActor, PlanAdminDeniedError, SupportPlanAdminService, } from './support-plan-admin-service.js';
+export { type AutoAssignResult, type RankedSpecialist, ReassignDeniedError, ROUTING_WEIGHTS, SupportRoutingService, type SupportRoutingServiceOptions, } from './support-routing-service.js';
+export { type ApproveTimeEntryInput, type ApproveTimeEntryResult, type CorrectTimeEntryInput, type CorrectTimeEntryResult, type RejectTimeEntryInput, type ResolvedPlanTerms, TimeEntryApprovalDeniedError, TimeEntryApprovalService, type TimeEntryApprovalServiceOptions, } from './time-entry-approval-service.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,KAAK,UAAU,EACf,UAAU,GACX,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,mBAAmB,EACnB,KAAK,0BAA0B,EAC/B,KAAK,gBAAgB,GACtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,KAAK,uBAAuB,EAC5B,mBAAmB,EACnB,KAAK,0BAA0B,EAC/B,iBAAiB,GAClB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,KAAK,2BAA2B,EAChC,uBAAuB,EACvB,KAAK,8BAA8B,EACnC,KAAK,2BAA2B,GACjC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,YAAY,GACb,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC3B,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,yBAAyB,EACzB,iBAAiB,EACjB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,qBAAqB,EACrB,0BAA0B,EAC1B,KAAK,oBAAoB,EACzB,oBAAoB,GACrB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,KAAK,cAAc,EACnB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,mBAAmB,EACnB,eAAe,EACf,qBAAqB,EACrB,KAAK,4BAA4B,GAClC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,4BAA4B,EAC5B,wBAAwB,EACxB,KAAK,+BAA+B,GACrC,MAAM,kCAAkC,CAAC"}

package/dist/services/keyed-mutex.d.ts

@@ -0,0 +1,22 @@
+/**
+ * KeyedMutex — serialize async work per key within one process.
+ *
+ * Used where a read-then-write decision must not interleave for the same
+ * logical resource: intake's create-or-join per conversation key, and
+ * included-time consumption per case during time-entry approval. Keys chain
+ * promises, so concurrent callers for the same key run strictly in arrival
+ * order while different keys stay fully parallel; entries clean up when the
+ * last waiter finishes.
+ *
+ * Scope: in-process only. It covers the deployment shape these paths run in
+ * (one app process owns intake interceptors / approval actions); multi-
+ * replica deployments serialize at the app layer (sticky routing or a
+ * DB-level claim), which composes above these seams.
+ */
+export declare class KeyedMutex {
+    private readonly tails;
+    /** Run `fn` exclusively for `key`, after every earlier holder of it. */
+    run<T>(key: string, fn: () => Promise<T>): Promise<T>;
+}
+export default KeyedMutex;
+//# sourceMappingURL=keyed-mutex.d.ts.map

package/dist/services/keyed-mutex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyed-mutex.d.ts","sourceRoot":"","sources":["../../src/services/keyed-mutex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuC;IAE7D,wEAAwE;IAClE,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAmB5D;AAED,eAAe,UAAU,CAAC"}