@happyvertical/smrt-support 0.51.31 → 0.51.33

package/dist/manifest.json

@@ -2,7 +2,7 @@
   "version": "1.0.0",
   "timestamp": 0,
   "packageName": "@happyvertical/smrt-support",
-  "packageVersion": "0.51.31",
+  "packageVersion": "0.51.33",
   "objects": {
     "@happyvertical/smrt-support:ServiceTimeEntry": {
       "name": "servicetimeentry",
@@ -2059,6 +2059,20 @@
           "isStatic": false,
           "isPublic": true
         },
+        "attemptTriageDecision": {
+          "name": "attemptTriageDecision",
+          "async": true,
+          "parameters": [
+            {
+              "name": "request",
+              "type": "DecisionRequest",
+              "optional": false
+            }
+          ],
+          "returnType": "Promise<DecisionResult | undefined>",
+          "isStatic": false,
+          "isPublic": true
+        },
         "initialize": {
           "name": "initialize",
           "async": true,
@@ -5025,6 +5039,11 @@
           "required": false,
           "_meta": {}
         },
+        "allowedCategories": {
+          "type": "text",
+          "required": false,
+          "_meta": {}
+        },
         "allowedTools": {
           "type": "text",
           "required": false,
@@ -5059,6 +5078,28 @@
           "isStatic": false,
           "isPublic": true
         },
+        "getAllowedCategories": {
+          "name": "getAllowedCategories",
+          "async": false,
+          "parameters": [],
+          "returnType": "string[]",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "setAllowedCategories": {
+          "name": "setAllowedCategories",
+          "async": false,
+          "parameters": [
+            {
+              "name": "categories",
+              "type": "string[]",
+              "optional": false
+            }
+          ],
+          "returnType": "void",
+          "isStatic": false,
+          "isPublic": true
+        },
         "getAllowedTools": {
           "name": "getAllowedTools",
           "async": false,
@@ -5148,7 +5189,7 @@
       "collectionExportName": "SupportPolicyCollection",
       "schema": {
         "tableName": "support_policies",
-        "ddl": "CREATE TABLE IF NOT EXISTS \"support_policies\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID,\n  \"name\" TEXT DEFAULT '',\n  \"plan_id\" UUID,\n  \"project_id\" TEXT,\n  \"enabled\" BOOLEAN,\n  \"auto_acknowledge\" BOOLEAN,\n  \"auto_classify\" BOOLEAN,\n  \"auto_answer\" BOOLEAN,\n  \"auto_troubleshoot\" BOOLEAN,\n  \"auto_resolve\" BOOLEAN,\n  \"auto_resolve_max_severity\" TEXT,\n  \"confidence_threshold\" REAL DEFAULT 0.7,\n  \"max_auto_attempts\" INTEGER DEFAULT 1,\n  \"auto_send_email_replies\" BOOLEAN,\n  \"sensitive_categories\" TEXT,\n  \"allowed_tools\" TEXT,\n  \"metadata\" TEXT\n);",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"support_policies\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID,\n  \"name\" TEXT DEFAULT '',\n  \"plan_id\" UUID,\n  \"project_id\" TEXT,\n  \"enabled\" BOOLEAN,\n  \"auto_acknowledge\" BOOLEAN,\n  \"auto_classify\" BOOLEAN,\n  \"auto_answer\" BOOLEAN,\n  \"auto_troubleshoot\" BOOLEAN,\n  \"auto_resolve\" BOOLEAN,\n  \"auto_resolve_max_severity\" TEXT,\n  \"confidence_threshold\" REAL DEFAULT 0.7,\n  \"max_auto_attempts\" INTEGER DEFAULT 1,\n  \"auto_send_email_replies\" BOOLEAN,\n  \"sensitive_categories\" TEXT,\n  \"allowed_categories\" TEXT,\n  \"allowed_tools\" TEXT,\n  \"metadata\" TEXT\n);",
         "columns": {
           "id": {
             "type": "UUID",
@@ -5261,6 +5302,11 @@
             "notNull": false,
             "unique": false
           },
+          "allowed_categories": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
           "allowed_tools": {
             "type": "TEXT",
             "notNull": false,
@@ -5303,7 +5349,7 @@
             ]
           }
         ],
-        "version": "61b60e25"
+        "version": "db53199e"
       },
       "importPath": "@happyvertical/smrt-support"
     },
@@ -5343,7 +5389,7 @@
       "collectionExportName": "SupportPolicyCollectionCollection",
       "schema": {
         "tableName": "support_policies",
-        "ddl": "CREATE TABLE IF NOT EXISTS \"support_policies\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID,\n  \"name\" TEXT DEFAULT '',\n  \"plan_id\" UUID,\n  \"project_id\" TEXT,\n  \"enabled\" BOOLEAN,\n  \"auto_acknowledge\" BOOLEAN,\n  \"auto_classify\" BOOLEAN,\n  \"auto_answer\" BOOLEAN,\n  \"auto_troubleshoot\" BOOLEAN,\n  \"auto_resolve\" BOOLEAN,\n  \"auto_resolve_max_severity\" TEXT,\n  \"confidence_threshold\" REAL DEFAULT 0.7,\n  \"max_auto_attempts\" INTEGER DEFAULT 1,\n  \"auto_send_email_replies\" BOOLEAN,\n  \"sensitive_categories\" TEXT,\n  \"allowed_tools\" TEXT,\n  \"metadata\" TEXT\n);",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"support_policies\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID,\n  \"name\" TEXT DEFAULT '',\n  \"plan_id\" UUID,\n  \"project_id\" TEXT,\n  \"enabled\" BOOLEAN,\n  \"auto_acknowledge\" BOOLEAN,\n  \"auto_classify\" BOOLEAN,\n  \"auto_answer\" BOOLEAN,\n  \"auto_troubleshoot\" BOOLEAN,\n  \"auto_resolve\" BOOLEAN,\n  \"auto_resolve_max_severity\" TEXT,\n  \"confidence_threshold\" REAL DEFAULT 0.7,\n  \"max_auto_attempts\" INTEGER DEFAULT 1,\n  \"auto_send_email_replies\" BOOLEAN,\n  \"sensitive_categories\" TEXT,\n  \"allowed_categories\" TEXT,\n  \"allowed_tools\" TEXT,\n  \"metadata\" TEXT\n);",
         "columns": {
           "id": {
             "type": "UUID",
@@ -5456,6 +5502,11 @@
             "notNull": false,
             "unique": false
           },
+          "allowed_categories": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
           "allowed_tools": {
             "type": "TEXT",
             "notNull": false,
@@ -5498,7 +5549,7 @@
             ]
           }
         ],
-        "version": "61b60e25"
+        "version": "db53199e"
       },
       "importPath": "@happyvertical/smrt-support"
     },

package/dist/migrations/moneyMinorUnits.d.ts

@@ -1,4 +1,33 @@
-import { DatabaseInterface, MinorUnitsPreflightResult, MinorUnitsRescaleResult, MoneyColumnTarget } from '@happyvertical/smrt-core/migrations';
+/**
+ * Support money columns: floating-point major units → integer minor units.
+ *
+ * Ships as an explicit, opt-in migration rather than a schema-differ upgrade
+ * because REAL→INTEGER is not information-preserving: an automatic
+ * `ALTER … TYPE integer` would truncate `19.99` to `19`. The values have to be
+ * rescaled by the currency's minor-unit factor during the type change (#2401).
+ *
+ * ```ts
+ * console.log((await preflightSupportMoneyMinorUnits(db)).summary);
+ * await migrateSupportMoneyToMinorUnits(db);
+ * ```
+ *
+ * **Rate columns are deliberately absent.** `SupportPlan.overageHourlyRate`,
+ * `SupportPlan.onCallHourlyRate` and `SupportCompensationPlan.hourlyRate` stay
+ * DECIMAL — a rate is inherently fractional — but their *unit* changes from
+ * major units per hour to **minor units per hour**, so existing rows must be
+ * multiplied by the same scale. That is a value change with no type change, and
+ * the column list below cannot express it; rescale them in the same deploy
+ * step, e.g. `UPDATE support_plans SET overage_hourly_rate = overage_hourly_rate * 100`.
+ *
+ * Frozen `rateSnapshot` JSON on already-settled charges is history and is left
+ * alone: it records what the rate was when the charge was priced, and the
+ * amount beside it is rescaled by this migration.
+ *
+ * On SQLite the values are rescaled but the declared type cannot change in
+ * place; those columns come back in `declaredTypeChangePending` and need the
+ * table-rebuild path (#2370).
+ */
+import { type DatabaseInterface, type MinorUnitsPreflightResult, type MinorUnitsRescaleResult, type MoneyColumnTarget } from '@happyvertical/smrt-core/migrations';
 /** Marker recorded in `_smrt_backfills` once the rescale has run. */
 export declare const SUPPORT_MONEY_MINOR_UNITS_BACKFILL = "@happyvertical/smrt-support:money-minor-units:v1";
 /** Every support money column that held major units before #2401. */

package/dist/models/service-time-entry.d.ts

@@ -1,5 +1,6 @@
+/** Compatibility mapping for issue #1955. */
 import { SmrtCollection } from '@happyvertical/smrt-core';
-import { ServiceParticipantKind, ServiceTimeEntrySource, ServiceTimeEntryStatus, ServiceTimeEntry as SharedServiceTimeEntry } from '@happyvertical/smrt-projects';
+import { type ServiceParticipantKind, type ServiceTimeEntrySource, type ServiceTimeEntryStatus, ServiceTimeEntry as SharedServiceTimeEntry } from '@happyvertical/smrt-projects';
 /**
  * Source-compatible support subtype over the shared canonical table. The
  * fields are restated because package-isolated manifest scanning deliberately

package/dist/models/support-ai-run.d.ts

@@ -1,5 +1,15 @@
+/**
+ * SupportAiRun — the auditable record of one Automated Support Response phase
+ * (FR-28a): what the AI attempted (acknowledge / classify / answer /
+ * troubleshoot / resolve), with confidence, classification output, knowledge
+ * references, attempted tool calls, and outcome. This is the "prior automated
+ * work" a Human Handoff transfers losslessly (FR-28b).
+ *
+ * Append-only: generated surface is `list`/`get`; the workflow writes each
+ * run once and never rewrites history.
+ */
 import { SmrtCollection, SmrtObject } from '@happyvertical/smrt-core';
-import { SupportAiRunOutcome, SupportAiRunPhase } from '../types.js';
+import { type SupportAiRunOutcome, type SupportAiRunPhase } from '../types.js';
 export declare class SupportAiRun extends SmrtObject {
     tenantId: string | null;
     caseId: string;
@@ -8,8 +18,10 @@ export declare class SupportAiRun extends SmrtObject {
     phase: SupportAiRunPhase;
     outcome: SupportAiRunOutcome;
     /**
-     * Model-reported confidence in [0, 1] for answer/classify/resolve phases;
-     * null when the phase has no confidence semantics (e.g. acknowledge).
+     * Model-reported answer/resolve confidence or the classification audit
+     * certainty in [0, 1]. Classification certainty is not calibrated answer
+     * confidence and never controls the answer policy threshold. Null when the
+     * phase has no confidence semantics (e.g. acknowledge).
      */
     confidence: number | null;
     /** Classification output JSON: severity, category, sentiment, sensitive. */

package/dist/models/support-ai-run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"support-ai-run.d.ts","sourceRoot":"","sources":["../../src/models/support-ai-run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAGL,cAAc,EACd,UAAU,EAEX,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAC;AAErB,qBAOa,YAAa,SAAQ,UAAU;IAE1C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAG/B,MAAM,EAAE,MAAM,CAAM;IAEpB,oEAAoE;IAEpE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAQ;IAGpC,KAAK,EAAE,iBAAiB,CAAiB;IAGzC,OAAO,EAAE,mBAAmB,CAAe;IAE3C;;;OAGG;IAEH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEjC,4EAA4E;IAE5E,cAAc,EAAE,MAAM,CAAQ;IAE9B,wEAAwE;IAExE,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE5C,yEAAyE;IAEzE,aAAa,EAAE,MAAM,CAAQ;IAE7B,gEAAgE;IAEhE,SAAS,EAAE,MAAM,CAAQ;IAEzB,gDAAgD;IAEhD,KAAK,EAAE,MAAM,CAAM;IAEnB,6EAA6E;IAE7E,aAAa,EAAE,MAAM,CAAM;IAE3B,yCAAyC;IAEzC,KAAK,EAAE,MAAM,CAAM;IAEnB,SAAS,EAAE,IAAI,CAAc;IAE7B,WAAW,EAAE,IAAI,GAAG,IAAI,CAAQ;IAGhC,QAAQ,EAAE,MAAM,CAAQ;IAExB,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI5C,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIvD,gBAAgB,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAIlD,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI;IAI5D,YAAY,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAI9C,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI;CAG1D;AAED,qBAAa,sBAAuB,SAAQ,cAAc,CAAC,YAAY,CAAC;IACtE,MAAM,CAAC,QAAQ,CAAC,UAAU,sBAAgB;IAE1C,4CAA4C;IACtC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAGvD;AAED,eAAe,YAAY,CAAC"}
+{"version":3,"file":"support-ai-run.d.ts","sourceRoot":"","sources":["../../src/models/support-ai-run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAGL,cAAc,EACd,UAAU,EAEX,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAC;AAErB,qBAOa,YAAa,SAAQ,UAAU;IAE1C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAG/B,MAAM,EAAE,MAAM,CAAM;IAEpB,oEAAoE;IAEpE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAQ;IAGpC,KAAK,EAAE,iBAAiB,CAAiB;IAGzC,OAAO,EAAE,mBAAmB,CAAe;IAE3C;;;;;OAKG;IAEH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEjC,4EAA4E;IAE5E,cAAc,EAAE,MAAM,CAAQ;IAE9B,wEAAwE;IAExE,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE5C,yEAAyE;IAEzE,aAAa,EAAE,MAAM,CAAQ;IAE7B,gEAAgE;IAEhE,SAAS,EAAE,MAAM,CAAQ;IAEzB,gDAAgD;IAEhD,KAAK,EAAE,MAAM,CAAM;IAEnB,6EAA6E;IAE7E,aAAa,EAAE,MAAM,CAAM;IAE3B,yCAAyC;IAEzC,KAAK,EAAE,MAAM,CAAM;IAEnB,SAAS,EAAE,IAAI,CAAc;IAE7B,WAAW,EAAE,IAAI,GAAG,IAAI,CAAQ;IAGhC,QAAQ,EAAE,MAAM,CAAQ;IAExB,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI5C,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIvD,gBAAgB,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAIlD,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI;IAI5D,YAAY,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAI9C,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI;CAG1D;AAED,qBAAa,sBAAuB,SAAQ,cAAc,CAAC,YAAY,CAAC;IACtE,MAAM,CAAC,QAAQ,CAAC,UAAU,sBAAgB;IAE1C,4CAA4C;IACtC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAGvD;AAED,eAAe,YAAY,CAAC"}

package/dist/models/support-case-event.d.ts

@@ -1,5 +1,15 @@
+/**
+ * SupportCaseEvent — append-only audit trail for a Support Case: creations,
+ * transitions, assignments, AI runs, handoffs, escalations, target state
+ * changes, work links, and reopens. Together with interactions this is the
+ * "complete Case context" a Human Handoff transfers (FR-28b) and the reopen
+ * history FR-29b preserves.
+ *
+ * Events are immutable: the generated surface is `list`/`get` only and the
+ * service never updates an event after writing it.
+ */
 import { SmrtCollection, SmrtObject } from '@happyvertical/smrt-core';
-import { SupportActorKind, SupportCaseEventType } from '../types.js';
+import { type SupportActorKind, type SupportCaseEventType } from '../types.js';
 export declare class SupportCaseEvent extends SmrtObject {
     tenantId: string | null;
     caseId: string;

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

@@ -1,5 +1,16 @@
-import { SmrtCollection, SmrtObject } from '@happyvertical/smrt-core';
-import { SupportCaseStatus } from '../types.js';
+/**
+ * SupportCase — the canonical, tenant-scoped record of a client support
+ * request (FR-28/FR-29): one Case per request across every channel, carrying
+ * priority, severity, plan snapshot, lifecycle state, assignment, resolution,
+ * and reopen history.
+ *
+ * Internal model — writes go through {@link SupportCaseService} (closed-facade
+ * idiom, mirroring `smrt-chat`'s `ChatService`). The generated CRUD surface is
+ * read-only (`list`/`get`); the save-time transition guard below additionally
+ * rejects illegal status flips done via raw field assignment.
+ */
+import { type DecisionRequest, type DecisionResult, SmrtCollection, SmrtObject } from '@happyvertical/smrt-core';
+import { type SupportCaseStatus } from '../types.js';
 /** Generate a short human-facing case number (unique enough per tenant). */
 export declare function generateCaseNumber(now?: Date): string;
 export declare class SupportCase extends SmrtObject {
@@ -84,6 +95,14 @@ export declare class SupportCase extends SmrtObject {
     updateMetadata(patch: Record<string, unknown>): void;
     getPlanSnapshot(): Record<string, unknown>;
     setPlanSnapshot(value: Record<string, unknown>): void;
+    /**
+     * Attempt typed support triage without changing the established tool route.
+     *
+     * A configured decision client is deliberately resolved only after the tool
+     * guard, matching the core routing rule. `undefined` means the caller must
+     * use its legacy generative behavior.
+     */
+    attemptTriageDecision(request: DecisionRequest): Promise<DecisionResult | undefined>;
     /**
      * Capture the status the row was loaded with so the save-time guard can
      * reject illegal flips made via raw field assignment.

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

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

package/dist/models/support-channel-binding.d.ts

@@ -1,5 +1,15 @@
+/**
+ * SupportChannelBinding — marks a transport container (a chat room, an email
+ * account) as a Managed Support intake channel. Inbound activity on a bound
+ * container creates-or-joins Support Cases; unbound containers are never
+ * touched, so ordinary chat rooms and mailboxes stay out of the support
+ * system.
+ *
+ * Bindings are configuration (operator-managed), so unlike the case-side
+ * models they expose full generated CRUD.
+ */
 import { SmrtCollection, SmrtObject } from '@happyvertical/smrt-core';
-import { SupportBindingKind, SupportChannelKind } from '../types.js';
+import { type SupportBindingKind, type SupportChannelKind } from '../types.js';
 export declare class SupportChannelBinding extends SmrtObject {
     tenantId: string | null;
     /** Operator-facing binding name (inherited `name` is the display label). */

package/dist/models/support-compensation-plan.d.ts

@@ -1,3 +1,14 @@
+/**
+ * SupportCompensationPlan — the provider-facing **Support Compensation Plan**
+ * (FR-32/FR-35): the effective-dated terms under which a Support Specialist
+ * earns for delivered support time. Deliberately separate from
+ * {@link SupportPlan} (client pricing) so margin stays measurable and client
+ * terms never leak provider terms.
+ *
+ * Resolution: the specialist-specific plan effective at the work instant
+ * wins; otherwise the tenant default (`specialistId` null) effective at that
+ * instant applies.
+ */
 import { SmrtCollection, SmrtObject } from '@happyvertical/smrt-core';
 export declare class SupportCompensationPlan extends SmrtObject {
     tenantId: string | null;

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

@@ -1,5 +1,16 @@
+/**
+ * SupportInteraction — a channel-neutral transport record attached to a
+ * Support Case (FR-28/FR-29): one row per message/chat/email/voice exchange,
+ * preserving chronology and transport metadata. The channel row (a
+ * `ChatMessage`, an `Email`, …) stays in its own package; this row links it
+ * via a qualified `sourceType`/`sourceId` pair and a globally unique
+ * `sourceKey` so re-ingesting the same transport record is idempotent.
+ *
+ * Internal model — writes go through {@link SupportCaseService}. Generated
+ * surface is read-only.
+ */
 import { SmrtCollection, SmrtObject } from '@happyvertical/smrt-core';
-import { SupportActorKind, SupportChannelKind, SupportInteractionDirection } from '../types.js';
+import { type SupportActorKind, type SupportChannelKind, type SupportInteractionDirection } from '../types.js';
 export declare class SupportInteraction extends SmrtObject {
     tenantId: string | null;
     caseId: string;

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

@@ -1,5 +1,23 @@
+/**
+ * SupportPlan — the client-facing **Managed Support Plan** (FR-31): coverage
+ * hours and channels, severity definitions, acknowledgement / response /
+ * update / resolution Service Targets, pause rules, escalation policy, an
+ * availability fee, included support time, and metered overage pricing.
+ *
+ * Pure hourly support is a plan with zero availability fee and zero included
+ * minutes. A Service Target here is an operational objective — it becomes a
+ * contractual Service Level Agreement only in the governing agreement, which
+ * is out of this package's scope.
+ *
+ * Client pricing lives here; Support Specialist earnings live in the separate
+ * {@link SupportCompensationPlan} — the two are never merged (FR-32/FR-35).
+ *
+ * `subscriptionPlanKey` optionally binds the plan to a
+ * `@happyvertical/smrt-subscriptions` plan by its natural key for entitlement
+ * checks — a string reference, deliberately not a package dependency.
+ */
 import { SmrtCollection, SmrtObject } from '@happyvertical/smrt-core';
-import { CoverageWindow, EscalationStep, ServiceTargetMinutes, SeverityDefinition, TimeApprovalPolicy } from '../types.js';
+import { type CoverageWindow, type EscalationStep, type ServiceTargetMinutes, type SeverityDefinition, type TimeApprovalPolicy } from '../types.js';
 /** Default target minutes applied when a plan omits a severity's targets. */
 export declare const DEFAULT_TARGET_MINUTES: ServiceTargetMinutes;
 export declare class SupportPlan extends SmrtObject {

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

@@ -1,3 +1,14 @@
+/**
+ * SupportPolicy — governs what the AI support workflow may do without a human
+ * (FR-28a/FR-28b): which phases run automatically, whether low-risk
+ * resolutions may complete autonomously, the confidence floor, sensitive
+ * categories, and the tool whitelist for troubleshooting.
+ *
+ * Resolution is most-specific-wins per case: `(planId, projectId)` exact →
+ * `planId` → `projectId` → tenant default (both null) → the package's
+ * conservative built-in defaults (see `DEFAULT_SUPPORT_POLICY`). Policies are
+ * operator configuration, so they expose full generated CRUD.
+ */
 import { SmrtCollection, SmrtObject } from '@happyvertical/smrt-core';
 /**
  * Conservative defaults applied when no SupportPolicy row matches: the AI
@@ -16,6 +27,7 @@ export declare const DEFAULT_SUPPORT_POLICY: {
     readonly maxAutoAttempts: 1;
     readonly autoSendEmailReplies: false;
     readonly sensitiveCategories: string[];
+    readonly allowedCategories: string[];
     readonly allowedTools: string[];
 };
 export declare class SupportPolicy extends SmrtObject {
@@ -56,11 +68,18 @@ export declare class SupportPolicy extends SmrtObject {
      * triggers a Human Handoff (FR-28b). JSON array of category keys.
      */
     sensitiveCategories: string;
+    /**
+     * Optional closed vocabulary for AI classification categories. Empty keeps
+     * the legacy free-vocabulary category generation path.
+     */
+    allowedCategories: string;
     /** Tool ids the troubleshooting phase may execute. JSON array, fail-closed. */
     allowedTools: string;
     metadata: string;
     getSensitiveCategories(): string[];
     setSensitiveCategories(categories: string[]): void;
+    getAllowedCategories(): string[];
+    setAllowedCategories(categories: string[]): void;
     getAllowedTools(): string[];
     setAllowedTools(tools: string[]): void;
     getMetadata(): Record<string, unknown>;

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

@@ -1 +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"}
+{"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;gCACV,MAAM,EAAE;2BACb,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;;;OAGG;IAEH,iBAAiB,EAAE,MAAM,CAAQ;IAEjC,+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,oBAAoB,IAAI,MAAM,EAAE;IAIhC,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI;IAIhD,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

@@ -1,5 +1,19 @@
+/**
+ * Service Target clocks and escalations (FR-30/FR-31).
+ *
+ * - **SupportServiceTarget** — one acknowledgement/response/update/resolution
+ *   clock on a case, derived from the applicable plan's targets, coverage
+ *   calendar, and pause rules. `escalationJobId` holds the one-shot
+ *   `_smrt_jobs` row scheduled at `dueAt` so satisfying the target can cancel
+ *   the pending escalation.
+ * - **SupportEscalation** — the auditable record of one escalation firing
+ *   (target breach, target risk, manual, or AI-triggered).
+ *
+ * Both are written by the target engine / case service only; generated
+ * surfaces are read-only.
+ */
 import { SmrtCollection, SmrtObject } from '@happyvertical/smrt-core';
-import { ServiceTargetStatus, ServiceTargetType, SupportEscalationReason } from '../types.js';
+import { type ServiceTargetStatus, type ServiceTargetType, type SupportEscalationReason } from '../types.js';
 /** Outcome of one {@link SupportServiceTarget.checkAndEscalate} delivery. */
 export interface CheckAndEscalateResult {
     outcome: 'breached' | 'escalated' | 'rescheduled' | 'noop' | 'missing';

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

@@ -1,5 +1,24 @@
+/**
+ * Derived commercial snapshots for approved Service Time Entries
+ * (FR-32/FR-35, issue #1930). Two deliberately separate rows per entry:
+ *
+ * - **SupportCharge** — what the Client owes, derived from the Managed
+ *   Support Plan (included-time consumption, then metered overage).
+ * - **SupportCompensation** — what the delivering Participant earns, derived
+ *   from the Support Compensation Plan.
+ *
+ * Margin = charge − compensation, computed by readers; the two records are
+ * never merged so client pricing can't leak provider terms. Rows snapshot the
+ * rate terms at derivation time (`rateSnapshot`) — later plan edits never
+ * rewrite them; corrections void/supersede and re-derive from the correcting
+ * entry. Settlement (invoicing, ledger posting) is out of scope here and
+ * composes at the app/accounting boundary (#1925).
+ *
+ * Append-only surfaces: `list`/`get` generated routes only; writes go through
+ * `TimeEntryApprovalService`.
+ */
 import { SmrtCollection, SmrtObject } from '@happyvertical/smrt-core';
-import { SupportSettlementStatus } from '../types.js';
+import { type SupportSettlementStatus } from '../types.js';
 export declare class SupportCharge extends SmrtObject {
     tenantId: string | null;
     timeEntryId: string;

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

@@ -1,5 +1,19 @@
+/**
+ * Support Specialist models (FR-30): the specialist role record layered on a
+ * Profile (the `commerce Customer` role-record idiom), per-project
+ * qualifications, and availability/on-call windows.
+ *
+ * - **SupportSpecialist** — a Participant qualified to handle first-tier
+ *   support; workload cap, languages, and timezone drive routing.
+ * - **SupportQualification** — recognition that a specialist is trained and
+ *   approved for a specific app-defined project (effective-dated).
+ * - **SupportAvailability** — weekly working windows, on-call spans, and
+ *   time-off exceptions used by routing and coverage checks.
+ *
+ * These are operator configuration surfaces, so they expose generated CRUD.
+ */
 import { SmrtCollection, SmrtObject } from '@happyvertical/smrt-core';
-import { SupportAvailabilityKind, SupportQualificationLevel, SupportSpecialistStatus } from '../types.js';
+import { type SupportAvailabilityKind, type SupportQualificationLevel, type SupportSpecialistStatus } from '../types.js';
 export declare class SupportSpecialist extends SmrtObject {
     tenantId: string | null;
     /** The Participant (Person profile) this specialist role belongs to. */

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

@@ -1,5 +1,17 @@
+/**
+ * SupportWorkLink — links a Support Case to separately tracked internal work
+ * (FR-29/FR-29a): a **Support Work Item** on the operational board, or a
+ * **Development Work Item** created through a Delivery Handoff.
+ *
+ * Boundary: Support owns the Case and this link; Delivery Operations owns the
+ * linked work's execution (agents, previews, merges, deployments). The
+ * `status` field here is a read-only echo the delivery side reports back —
+ * this package never drives the linked item's lifecycle. Targets are
+ * addressed by qualified type + id (e.g. `@happyvertical/smrt-projects:Issue`)
+ * so no runtime dependency on the owning package is needed.
+ */
 import { SmrtCollection, SmrtObject } from '@happyvertical/smrt-core';
-import { SupportWorkLinkKind } from '../types.js';
+import { type SupportWorkLinkKind } from '../types.js';
 export declare class SupportWorkLink extends SmrtObject {
     tenantId: string | null;
     caseId: string;

package/dist/permissions.d.ts

@@ -1,4 +1,15 @@
-import { PermissionDefinition } from '@happyvertical/smrt-users';
+/**
+ * Custom permission slugs contributed by `@happyvertical/smrt-support` to the
+ * runtime permission catalog (the `personas.activate-directive` pattern).
+ *
+ * The privileged operations are permission splits, not bespoke checks:
+ * - `support.reassign-case` — manual reassignment despite routing (FR-30).
+ * - `support.approve-time-entry` — accept a Service Time Entry and derive its
+ *   commercial snapshots (FR-36) via the operator path.
+ * - `support.manage-plans` — administer Managed Support Plans and Support
+ *   Compensation Plans.
+ */
+import { type 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. */

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

@@ -1,4 +1,25 @@
-import { CoverageWindow } from '../types.js';
+/**
+ * Coverage-calendar math for Service Target clocks (FR-30/FR-31): pure,
+ * deterministic business-time arithmetic over a Managed Support Plan's
+ * coverage windows, holidays, and IANA timezone.
+ *
+ * Semantics:
+ * - An empty `windows` array means 24×7 coverage; with no holidays either,
+ *   covered time is plain wall-clock time (the fast path).
+ * - Holidays (`YYYY-MM-DD` in the calendar's timezone) exclude whole days
+ *   from coverage, including under 24×7 coverage.
+ * - All functions take explicit instants — no `Date.now()` inside — so the
+ *   engine and its tests stay deterministic.
+ *
+ * Timezone handling uses `Intl.DateTimeFormat#formatToParts` only (no date
+ * library): {@link zonedParts} projects a UTC instant onto the calendar
+ * timezone's wall clock, and an iterative inverse converts wall-clock day
+ * positions back to UTC instants. DST transition days therefore keep exact
+ * window boundaries; a window boundary falling inside a nonexistent
+ * spring-forward hour lands on the later real instant so clocks never gain
+ * time.
+ */
+import type { CoverageWindow } from '../types.js';
 /** The coverage terms a Service Target clock runs against. */
 export interface CoverageCalendar {
     /** Weekly coverage windows; empty means 24×7 coverage. */

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

@@ -1,7 +1,22 @@
-import { SmrtObjectOptions } from '@happyvertical/smrt-core';
+/**
+ * HumanHandoffService — the lossless Human Handoff (FR-28b, issue #1928).
+ * Whatever pulls the trigger (an explicit client request, low answer
+ * confidence, a sensitive classification, high severity, failed automation,
+ * a policy cap, or a manual escalation), the handoff transfers the FULL case
+ * context — current state, the merged interaction/event timeline, and every
+ * prior {@link SupportAiRun} — so the Client never repeats themselves and the
+ * Support Specialist starts with the complete history.
+ *
+ * A no-repeat guarantee keeps at most one handoff active per case
+ * (`metadata.activeHandoff`): repeat triggers while one is pending only
+ * append a deduped audit event. Routing is a seam — the #1929 routing
+ * service plugs in via `assignSpecialist`; without it the case is queued for
+ * manual pickup (`new` → `triaged`).
+ */
+import type { 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 type { SupportCase } from '../models/support-case.js';
+import type { HumanHandoffTrigger } from '../types.js';
 import { SupportCaseService } from './support-case-service.js';
 /** One compact timeline entry inside a {@link HandoffContextPackage}. */
 export interface HandoffTimelineItem {

package/dist/services/project-assistance-adapter.d.ts

@@ -1,5 +1,5 @@
-import { SmrtObjectOptions } from '@happyvertical/smrt-core';
-import { AssistanceSupportPort } from '@happyvertical/smrt-projects';
+import type { SmrtObjectOptions } from '@happyvertical/smrt-core';
+import type { AssistanceSupportPort } from '@happyvertical/smrt-projects';
 import { SupportCaseService } from './support-case-service.js';
 /** Concrete lossless bridge from smrt-projects Assistance Requests to Support. */
 export declare class ProjectAssistanceSupportAdapter implements AssistanceSupportPort {

package/dist/services/service-target-engine.d.ts

@@ -1,10 +1,37 @@
-import { SmrtObjectOptions } from '@happyvertical/smrt-core';
+/**
+ * ServiceTargetEngine — Service Target clocks with timed escalation
+ * (FR-30/FR-31).
+ *
+ * Owns the full clock lifecycle on a case:
+ * - **start** — one clock per configured target type from the case's plan
+ *   terms (the frozen `planSnapshot` wins over the live plan; sensible
+ *   defaults with no plan), `dueAt` computed in *covered* time through the
+ *   plan's coverage calendar, plus a one-shot `_smrt_jobs` row
+ *   (`SupportServiceTarget.checkAndEscalate`) scheduled at `dueAt`;
+ * - **satisfy** — outbound specialist/agent interactions satisfy the
+ *   acknowledgement/response clocks and roll the recurring update clock to
+ *   its next cycle; satisfied clocks cancel their escalation job;
+ * - **pause/resume** — case statuses listed in the plan's `pauseStatuses`
+ *   freeze clocks (FR-29b: waiting periods pause clocks *only when the plan
+ *   says so*); resume recomputes `dueAt` from the remaining covered minutes
+ *   and enqueues a fresh job;
+ * - **resolve/reopen** — resolution satisfies the resolution clock and
+ *   cancels the rest; reopening starts fresh clocks on a new cycle;
+ * - **breach** — an overdue clock is marked breached and escalated through
+ *   the plan's escalation policy (notify or reassign via
+ *   {@link SupportRoutingService}), with optional delayed follow-up steps.
+ *
+ * The engine is invoked by the application around
+ * {@link SupportCaseService} calls; it deliberately takes explicit `at`
+ * instants so behavior is deterministic and testable.
+ */
+import type { SmrtObjectOptions } from '@happyvertical/smrt-core';
 import { SmrtJobCollection } from '@happyvertical/smrt-jobs';
-import { SupportCase } from '../models/support-case.js';
-import { SupportInteraction } from '../models/support-interaction.js';
-import { SupportEscalationCollection, SupportServiceTarget, SupportServiceTargetCollection } from '../models/support-service-target.js';
-import { EscalationStep, ServiceTargetMinutes, SupportCaseStatus } from '../types.js';
-import { CoverageCalendar } from './coverage-calendar.js';
+import type { SupportCase } from '../models/support-case.js';
+import type { SupportInteraction } from '../models/support-interaction.js';
+import { SupportEscalationCollection, type SupportServiceTarget, SupportServiceTargetCollection } from '../models/support-service-target.js';
+import { type EscalationStep, type ServiceTargetMinutes, type SupportCaseStatus } from '../types.js';
+import { type CoverageCalendar } from './coverage-calendar.js';
 import { SupportCaseService } from './support-case-service.js';
 /** Queue name for support escalation jobs. */
 export declare const SUPPORT_JOB_QUEUE = "support";