busroot-sdk 0.0.8-dev.2708365288 → 0.0.8-dev.2713878872

package/build/index.d.ts

@@ -3246,6 +3246,7 @@ declare class BusrootClient {
                 durationFormatted: string;
             };
             isOngoing: boolean;
+            note?: string | undefined;
             reasonBreadcrumb?: {
                 code: string;
                 description: string;

package/build/index.js

@@ -645,8 +645,8 @@ var require_error_key = __commonJS({
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.STATION_REASSIGN_CROSS_GROUP = exports2.TARGET_STATION_NOT_FOUND = exports2.PARTS_PER_CYCLE_NOT_ALLOWED_FOR_STATION = exports2.SCHEDULE_CANNOT_STOP_FUTURE = exports2.SCHEDULE_NON_PROD_OR_ENDED = exports2.SCHEDULE_CANNOT_CUT_SHORT = exports2.SCHEDULE_AUTO_ENDED_BY_QUANTITY = exports2.SCHEDULE_NOT_STARTED_OR_ENDED = exports2.ACTUAL_START_IN_PAST = exports2.PLANNED_START_IN_PAST = exports2.SCHEDULE_CANNOT_CHANGE_PROD_TO_NON_PROD = exports2.SCHEDULE_CANNOT_CHANGE_NON_PROD_TO_PROD = exports2.SCHEDULE_CANNOT_SET_PRIORITY_AFTER_START = exports2.SCHEDULE_ALREADY_STARTED_CANNOT_EDIT_START = exports2.SCHEDULE_ALREADY_ENDED = exports2.UNSUPPORTED_SCHEDULE_OPERATION = exports2.INVALID_RESOLUTION_MODE = exports2.EXISTED_EVENT = exports2.INVALID_SEARCH_TEXT = exports2.INVALID_SKIP = exports2.INVALID_LIMIT = exports2.INVALID_WINDOW_TIME = exports2.INVALID_NOTIFICATION_PREFERENCE = exports2.OVERLAPPED_SHIFT = exports2.INVALID_SHIFT_NAME = exports2.INVALID_WEEK_DAY = exports2.INVALID_FILE_TYPE = exports2.INVALID_HEADER_FIELDS = exports2.DELETE_LAST_SHIFT_PATTERN = exports2.INVALID_ACTUAL_START_AT_STATE = exports2.INVALID_DOMAIN = exports2.SKU_NOT_FOUND = exports2.STATION_GROUP_NOT_FOUND = exports2.WORK_ORDER_ENDED = exports2.SCHEDULE_NOT_FOUND = exports2.INVALID_SKU = exports2.INVALID_SCHEDULE = exports2.EXPIRED_TOKEN = exports2.UNAUTHORIZED_USER = exports2.UNAUTHENTICATED_USER = exports2.SHIFT_PATTERN_NOT_FOUND = exports2.INVALID_SHIFT_PATTERN_TITLE = exports2.INVALID_SHIFT_PATTERN_ID = exports2.INVALID_DELETE_SHIFTS = exports2.UNSUPPORTED_SHIFT_OVER_MID_NIGHT = exports2.INVALID_SHIFTS = exports2.INVALID_PLANTCODE = exports2.INVALID_RANGECODE = exports2.INTERNAL_SERVER_ERROR = exports2.CACHE_NOT_COMPLETE = void 0;
-    exports2.DATABASE_ERROR_MESSAGE = exports2.INVALID_API_KEY = exports2.UNSUPPORTED_API_KEY_OPERATION = exports2.ACCOUNT_ARCHIVED = exports2.ACCOUNT_DENIED = exports2.ACCOUNT_NOT_FOUND = exports2.ACCOUNT_MISMATCH = exports2.USER_ACCOUNT_IS_BLOCKED = exports2.ACCOUNT_NOT_SELECTED = exports2.INVALID_USER_ACCOUNT = exports2.NO_ACCOUNT_AVAILABLE = exports2.EXPIRED_USER = exports2.USER_IS_BLOCKED = exports2.INVALID_USER = exports2.USER_NOT_FOUND = exports2.MULTIPLE_ACCOUNT_ASSOCIATED = exports2.UNSUPPORTED_USER_OPERATION = exports2.EMAIL_TYPE_NOT_FOUND = exports2.INVALID_STATION_CODE = exports2.DUPLICATED_STATION_CODE = exports2.DUPLICATED_STATION_GROUP_CODE = exports2.INVALID_INPUT = exports2.DUPLICATED_SKU_CODE = exports2.INVALID_SKU_CODE = exports2.TOO_LARGE = exports2.BUSINESS_CONFLICT = exports2.FORBIDDEN = exports2.INVALID_ACCESS_CODE = exports2.EXPIRED_API_KEY = exports2.UNSUPPORTED_ARCHIVE_LAST_PLANT = exports2.PLANT_NOT_EXISTS = exports2.NOT_EMPTY_STATION_GROUP = exports2.INVALID_AGGREGATE_WINDOW = exports2.DUPLICATED_SCHEDULE = exports2.INVALID_SCHEDULE_ORDER_TYPE = exports2.INVALID_SKU_GROUP_NAME = exports2.SKU_GROUP_NOT_FOUND = exports2.INVALID_SKU_GROUP = exports2.INVALID_DOWNTIMNE_DURATION_THRESHOLD_MULTIPLIER = exports2.REASON_NOT_DOWNTIME_TYPE = exports2.MANUAL_DOWNTIME_NO_ACTIVE_SCHEDULE = exports2.MANUAL_DOWNTIME_ALREADY_ONGOING = exports2.CACHE_WARMING_DISABLED = exports2.MANUAL_DOWNTIME_DISABLED = exports2.DOWNTIME_NOT_MANUAL = exports2.DOWNTIME_NOT_FOUND = exports2.STATION_NOT_FOUND = exports2.REASON_NOT_ALLOWED_FOR_STATION = exports2.REASON_NOT_FOUND = exports2.SKU_REQUIRED = void 0;
-    exports2.PRODUCTION_BLOCKED_BY_MANUAL_DOWNTIME = exports2.PRODUCTION_CORRECTION_NOT_ALLOWED = exports2.PRODUCTION_QUANTITY_BELOW_ZERO = exports2.INVALID_PRODUCTION_ID = exports2.RESET_EXCEED_30_DAYS = exports2.INVALID_REASON_CODE = exports2.SELF_REFERENCING_CODE = exports2.PARENT_CODE_IN_USE = exports2.DUPLICATED_REASON_CODE = void 0;
+    exports2.INVALID_API_KEY = exports2.UNSUPPORTED_API_KEY_OPERATION = exports2.ACCOUNT_ARCHIVED = exports2.ACCOUNT_DENIED = exports2.ACCOUNT_NOT_FOUND = exports2.ACCOUNT_MISMATCH = exports2.USER_ACCOUNT_IS_BLOCKED = exports2.ACCOUNT_NOT_SELECTED = exports2.INVALID_USER_ACCOUNT = exports2.NO_ACCOUNT_AVAILABLE = exports2.EXPIRED_USER = exports2.USER_IS_BLOCKED = exports2.INVALID_USER = exports2.USER_NOT_FOUND = exports2.MULTIPLE_ACCOUNT_ASSOCIATED = exports2.UNSUPPORTED_USER_OPERATION = exports2.EMAIL_TYPE_NOT_FOUND = exports2.INVALID_STATION_CODE = exports2.DUPLICATED_STATION_CODE = exports2.DUPLICATED_STATION_GROUP_CODE = exports2.INVALID_INPUT = exports2.DUPLICATED_SKU_CODE = exports2.INVALID_SKU_CODE = exports2.TOO_LARGE = exports2.BUSINESS_CONFLICT = exports2.FORBIDDEN = exports2.INVALID_ACCESS_CODE = exports2.EXPIRED_API_KEY = exports2.UNSUPPORTED_ARCHIVE_LAST_PLANT = exports2.PLANT_NOT_EXISTS = exports2.NOT_EMPTY_STATION_GROUP = exports2.INVALID_AGGREGATE_WINDOW = exports2.DUPLICATED_SCHEDULE = exports2.INVALID_SCHEDULE_ORDER_TYPE = exports2.INVALID_SKU_GROUP_NAME = exports2.SKU_GROUP_NOT_FOUND = exports2.INVALID_SKU_GROUP = exports2.INVALID_DOWNTIMNE_DURATION_THRESHOLD_MULTIPLIER = exports2.REASON_NOT_DOWNTIME_TYPE = exports2.MANUAL_DOWNTIME_NO_ACTIVE_SCHEDULE = exports2.MANUAL_DOWNTIME_ALREADY_ONGOING = exports2.CACHE_WARMING_DISABLED = exports2.MANUAL_DOWNTIME_DISABLED = exports2.DOWNTIME_NOT_MANUAL = exports2.DOWNTIME_NOT_FOUND = exports2.STATION_NOT_FOUND = exports2.REASON_NOTE_REQUIRED = exports2.REASON_NOT_ALLOWED_FOR_STATION = exports2.REASON_NOT_FOUND = exports2.SKU_REQUIRED = void 0;
+    exports2.PRODUCTION_BLOCKED_BY_MANUAL_DOWNTIME = exports2.PRODUCTION_CORRECTION_NOT_ALLOWED = exports2.PRODUCTION_QUANTITY_BELOW_ZERO = exports2.INVALID_PRODUCTION_ID = exports2.RESET_EXCEED_30_DAYS = exports2.INVALID_REASON_CODE = exports2.SELF_REFERENCING_CODE = exports2.PARENT_CODE_IN_USE = exports2.DUPLICATED_REASON_CODE = exports2.DATABASE_ERROR_MESSAGE = void 0;
     exports2.CACHE_NOT_COMPLETE = "cacheNotComplete";
     exports2.INTERNAL_SERVER_ERROR = "internalServerError";
     exports2.INVALID_RANGECODE = "invalidRangeCode";
@@ -700,6 +700,7 @@ var require_error_key = __commonJS({
     exports2.SKU_REQUIRED = "skuRequired";
     exports2.REASON_NOT_FOUND = "reasonNotFound";
     exports2.REASON_NOT_ALLOWED_FOR_STATION = "reasonNotAllowedForStation";
+    exports2.REASON_NOTE_REQUIRED = "reasonNoteRequired";
     exports2.STATION_NOT_FOUND = "stationNotFound";
     exports2.DOWNTIME_NOT_FOUND = "downtimeNotFound";
     exports2.DOWNTIME_NOT_MANUAL = "downtimeNotManual";
@@ -1833,15 +1834,18 @@ var require_base_reason = __commonJS({
     require_extend();
     var enums_1 = require_enums();
     exports2.ReasonCodeSchema = zod_1.z.string().trim().min(1).max(50).refine((value) => value === value.toLowerCase()).describe("Unique reason code used to reference this reason (e.g., 'MAINTENANCE', 'BREAKDOWN', 'PLANNED-PM'). Must be unique within the account.");
+    var REQUIRE_NOTES_DESCRIPTION = "Require Notes: When enabled, operators must enter notes before the reason can be confirmed. Only applies when the reason is assigned to a downtime.";
     exports2.BaseReasonSchema = zod_1.z.object({
       code: exports2.ReasonCodeSchema,
       description: zod_1.z.string().describe("Human-readable description of this reason (e.g., 'Planned maintenance', 'Equipment breakdown', 'Material shortage')"),
-      type: zod_1.z.array(zod_1.z.nativeEnum(enums_1.REASON_TYPE)).min(1).describe("Array of reason types this code applies to. Options: 'downtime' (for unplanned stoppages), 'non-production' (for planned activities), 'quality' (for bad/rejected production). A reason can have multiple types. Example: ['downtime'], ['non-production'], ['downtime', 'non-production']")
+      type: zod_1.z.array(zod_1.z.nativeEnum(enums_1.REASON_TYPE)).min(1).describe("Array of reason types this code applies to. Options: 'downtime' (for unplanned stoppages), 'non-production' (for planned activities), 'quality' (for bad/rejected production). A reason can have multiple types. Example: ['downtime'], ['non-production'], ['downtime', 'non-production']"),
+      requireNotes: zod_1.z.boolean().optional().describe(REQUIRE_NOTES_DESCRIPTION)
     }).strict();
     exports2.ManifestReasonSchema = zod_1.z.object({
       code: zod_1.z.string().describe("Unique reason code used to reference this reason (e.g., 'MAINTENANCE', 'BREAKDOWN', 'PLANNED-PM'). Must be unique within the account."),
       description: zod_1.z.string().describe("Human-readable description of this reason (e.g., 'Planned maintenance', 'Equipment breakdown', 'Material shortage')"),
       type: zod_1.z.array(zod_1.z.nativeEnum(enums_1.REASON_TYPE)).min(1).describe("Array of reason types this code applies to. Options: 'downtime' (for unplanned stoppages), 'non-production' (for planned activities), 'quality' (for bad/rejected production). A reason can have multiple types. Example: ['downtime'], ['non-production'], ['downtime', 'non-production']"),
+      requireNotes: zod_1.z.boolean().optional().describe(REQUIRE_NOTES_DESCRIPTION),
       reasons: zod_1.z.lazy(() => zod_1.z.array(exports2.ManifestReasonSchema)).optional().describe("Optional array of child reasons that are subcategories of this reason. Used to create hierarchical reason structures (e.g., 'Maintenance' \u2192 'Preventive Maintenance' \u2192 'PM Check').")
     }).strict().openapi({ ref: "ManifestReason" });
   }
@@ -1961,6 +1965,9 @@ var require_downtime = __commonJS({
       estimateEndAt: zod_1.z.string().optional(),
       notifiedAt: zod_1.z.string().optional(),
       causeCode: zod_1.z.string().optional(),
+      // Free-text detail captured when the reason was assigned. Mandatory for reasons flagged
+      // `requireNotes`; null on every event that predates the feature or does not require one.
+      note: zod_1.z.string().optional(),
       accountId: zod_1.z.string(),
       createdAt: zod_1.z.string(),
       updatedAt: zod_1.z.string(),
@@ -6115,17 +6122,20 @@ var require_issue = __commonJS({
   "../../packages/common/build/api-schemas/issue.js"(exports2) {
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.IssueEventPostRequestRefinement = exports2.IssueEventPostRequest = exports2.IssueEventQueryRequest = exports2.ManualDowntimeEndByStationRequest = exports2.IssuePostRequest = exports2.IssueIdGetRequest = void 0;
+    exports2.IssueEventPostRequestRefinement = exports2.IssueEventPostRequest = exports2.IssueEventQueryRequest = exports2.ManualDowntimeEndByStationRequest = exports2.IssuePostRequest = exports2.IssueIdGetRequest = exports2.DOWNTIME_NOTE_MAX_LENGTH = void 0;
     var zod_1 = require("zod");
     var enums_1 = require_enums();
     var schemas_1 = require_schemas();
     var IssueIdSchema = zod_1.z.coerce.number().int().gte(0);
+    exports2.DOWNTIME_NOTE_MAX_LENGTH = 250;
+    var DowntimeNoteSchema = zod_1.z.string().trim().max(exports2.DOWNTIME_NOTE_MAX_LENGTH).optional().describe(`Free-text note describing the downtime. Mandatory when the assigned reason has 'requireNotes' enabled, otherwise optional. Maximum ${exports2.DOWNTIME_NOTE_MAX_LENGTH} characters.`);
     exports2.IssueIdGetRequest = zod_1.z.object({
       id: IssueIdSchema
     });
     exports2.IssuePostRequest = zod_1.z.object({
       stationCode: schemas_1.StationCodeSchema,
-      reasonCode: zod_1.z.string().trim().min(1).describe("Reason code for the manual downtime. Must be a reason whose type includes 'downtime'.")
+      reasonCode: zod_1.z.string().trim().min(1).describe("Reason code for the manual downtime. Must be a reason whose type includes 'downtime'."),
+      note: DowntimeNoteSchema
     });
     exports2.ManualDowntimeEndByStationRequest = zod_1.z.object({
       stationCode: schemas_1.StationCodeSchema
@@ -6137,6 +6147,7 @@ var require_issue = __commonJS({
       type: zod_1.z.nativeEnum(enums_1.DowntimeEventType),
       estimatedTime: zod_1.z.number().nonnegative().optional(),
       causeCode: zod_1.z.string().trim().min(1).optional(),
+      note: DowntimeNoteSchema,
       operator: zod_1.z.string().optional()
     });
     exports2.IssueEventPostRequestRefinement = exports2.IssueEventPostRequest.refine((data) => data.type !== enums_1.DowntimeEventType.Estimate || data.estimatedTime !== void 0, {
@@ -6146,7 +6157,10 @@ var require_issue = __commonJS({
     }).transform((value) => ({
       ...value,
       estimatedTime: value.type === enums_1.DowntimeEventType.Estimate ? value.estimatedTime : void 0,
-      causeCode: value.type === enums_1.DowntimeEventType.Cause ? value.causeCode : void 0
+      causeCode: value.type === enums_1.DowntimeEventType.Cause ? value.causeCode : void 0,
+      // A note only means anything alongside a reason — drop it on every other event type,
+      // mirroring how causeCode is scoped.
+      note: value.type === enums_1.DowntimeEventType.Cause ? value.note || void 0 : void 0
     }));
   }
 });
@@ -6301,9 +6315,13 @@ var require_note2 = __commonJS({
       return mod && mod.__esModule ? mod : { "default": mod };
     };
     Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.DeleteNoteRequest = exports2.NotePostRequest = void 0;
+    exports2.DeleteNoteRequest = exports2.NotePostRequest = exports2.NoteGetRequest = void 0;
     var zod_1 = __importDefault(require("zod"));
     var schemas_1 = require_schemas();
+    var common_1 = require_common();
+    exports2.NoteGetRequest = zod_1.default.object({
+      excludehidden: common_1.BooleanTypeSchema.describe("Excludes notes hidden from the Cockpit / Station Notes page.")
+    });
     exports2.NotePostRequest = schemas_1.NoteSchema.omit({ accountId: true, updatedAt: true }).partial({ id: true, createdAt: true });
     exports2.DeleteNoteRequest = zod_1.default.object({
       id: zod_1.default.number({ coerce: true })
@@ -6382,7 +6400,7 @@ var require_api_schemas = __commonJS({
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.ScheduleEditPartsPerCycleOverridePostBodyRequest = exports2.ScheduleEditPartsPerCycleOverridePostParamRequest = exports2.ScheduleFutureGetParamRequest = exports2.ScheduleCutShortPostRequest = exports2.ScheduleDeleteRequest = exports2.SchedulePostRequestTransform = exports2.SchedulePostRequestSuperRefine = exports2.SchedulePostRequest = exports2.ScheduleWorkderGetRequest = exports2.ScheduleGetRequest = exports2.ReasonDeleteRequest = exports2.ReasonPostRequest = exports2.ReasonGetRequest = exports2.ReasonBreadcrumb = exports2.NotificationRefferencesRequest = exports2.StationGroupDeleteRquest = exports2.StationGroupGetRquest = exports2.StationGroupPostRequest = exports2.StationGroupCodeSchema = exports2.StationOperatorPostRequest = exports2.StationTargetGetRequest = exports2.StationWindowGetRequest = exports2.StationLogGetRequest = exports2.AdminStationPutBodyRequest = exports2.StationGetRequest = exports2.StationPostRequest = exports2.StationPostRequestTransform = exports2.StationPostRequestSuperRefine = exports2.StationDeleteRequest = exports2.AccountArchivePostRequest = exports2.AccountSettingPostRequest = exports2.SelectAccountPostRequest = exports2.NewAccountPostRequest = exports2.ArchivePlantPostRequest = exports2.PlantPostRequest = exports2.UserGetRequest = exports2.UserPostRequest = exports2.SkuCycleTimeAnalysisGetRequest = exports2.SkuDeleteRequest = exports2.SkuPostBulkRequest = exports2.SkuPostRequestTransform = exports2.SkuPostRequestSuperRefine = exports2.SkuPostRequest = exports2.BooleanTypeSchema = exports2.SortByStandardParam = exports2.BusrootPagingResponse = exports2.StandardRequestSuperRefine = exports2.StandardRequestParams = exports2.RangeCodeSchema = exports2.UNKNOWN_CODE = void 0;
-    exports2.BufferedDauMessageSchema = exports2.DauMessagesGetParams = exports2.AgentRequest = exports2.AgentMessage = exports2.TaskDeleteRequest = exports2.TaskPostRequest = exports2.NotePostRequest = exports2.DeleteNoteRequest = exports2.DeleteKeyDeleteRequest = exports2.FilterGetRequest = exports2.AccessCodeGetRequest = exports2.DebugMockClearPostRequest = exports2.DebugResetCursorPostRequest = exports2.DebugEmailDowntimeSummaryGetRequest = exports2.EmailTestHarnessPostRequestRefinement = exports2.EmailTestHarnessPostRequest = exports2.LoginPostRequest = exports2.CallBackGetRequest = exports2.DevicePostRequest = exports2.DeviceDeleteRequest = exports2.DashboardGetRquest = exports2.ManualDowntimeEndByStationRequest = exports2.IssueEventPostRequestRefinement = exports2.IssueEventPostRequest = exports2.IssueEventQueryRequest = exports2.IssuePostRequest = exports2.IssueIdGetRequest = exports2.ProductionAggregateWindowGetRequest = exports2.ProductionManualPostRequest = exports2.ShiftPatternDeleteRequest = exports2.ShiftPostRequest = exports2.ScheduleLogGetRequest = void 0;
+    exports2.BufferedDauMessageSchema = exports2.DauMessagesGetParams = exports2.AgentRequest = exports2.AgentMessage = exports2.TaskDeleteRequest = exports2.TaskPostRequest = exports2.NotePostRequest = exports2.NoteGetRequest = exports2.DeleteNoteRequest = exports2.DeleteKeyDeleteRequest = exports2.FilterGetRequest = exports2.AccessCodeGetRequest = exports2.DebugMockClearPostRequest = exports2.DebugResetCursorPostRequest = exports2.DebugEmailDowntimeSummaryGetRequest = exports2.EmailTestHarnessPostRequestRefinement = exports2.EmailTestHarnessPostRequest = exports2.LoginPostRequest = exports2.CallBackGetRequest = exports2.DevicePostRequest = exports2.DeviceDeleteRequest = exports2.DashboardGetRquest = exports2.ManualDowntimeEndByStationRequest = exports2.IssueEventPostRequestRefinement = exports2.IssueEventPostRequest = exports2.IssueEventQueryRequest = exports2.IssuePostRequest = exports2.IssueIdGetRequest = exports2.DOWNTIME_NOTE_MAX_LENGTH = exports2.ProductionAggregateWindowGetRequest = exports2.ProductionManualPostRequest = exports2.ShiftPatternDeleteRequest = exports2.ShiftPostRequest = exports2.ScheduleLogGetRequest = void 0;
     var common_1 = require_common();
     Object.defineProperty(exports2, "UNKNOWN_CODE", { enumerable: true, get: function() {
       return common_1.UNKNOWN_CODE;
@@ -6560,6 +6578,9 @@ var require_api_schemas = __commonJS({
       return production_1.ProductionAggregateWindowGetRequest;
     } });
     var issue_1 = require_issue();
+    Object.defineProperty(exports2, "DOWNTIME_NOTE_MAX_LENGTH", { enumerable: true, get: function() {
+      return issue_1.DOWNTIME_NOTE_MAX_LENGTH;
+    } });
     Object.defineProperty(exports2, "IssueIdGetRequest", { enumerable: true, get: function() {
       return issue_1.IssueIdGetRequest;
     } });
@@ -6626,6 +6647,9 @@ var require_api_schemas = __commonJS({
     Object.defineProperty(exports2, "DeleteNoteRequest", { enumerable: true, get: function() {
       return note_1.DeleteNoteRequest;
     } });
+    Object.defineProperty(exports2, "NoteGetRequest", { enumerable: true, get: function() {
+      return note_1.NoteGetRequest;
+    } });
     Object.defineProperty(exports2, "NotePostRequest", { enumerable: true, get: function() {
       return note_1.NotePostRequest;
     } });
@@ -6666,14 +6690,16 @@ var require_reason3 = __commonJS({
       code: zod_1.z.string(),
       description: zod_1.z.string(),
       parentReasonCode: zod_1.z.string().nullish(),
-      type: zod_1.z.array(zod_1.z.nativeEnum(enums_1.REASON_TYPE))
+      type: zod_1.z.array(zod_1.z.nativeEnum(enums_1.REASON_TYPE)),
+      requireNotes: zod_1.z.boolean().optional()
     });
     function toReasonViewModel(schemas) {
       return schemas.map((s) => ({
         code: s.code,
         description: s.description,
         type: s.type,
-        parentReasonCode: s.parentReasonCode
+        parentReasonCode: s.parentReasonCode,
+        requireNotes: s.requireNotes
       }));
     }
   }
@@ -7185,6 +7211,9 @@ var require_downtime2 = __commonJS({
       workOrderReference: zod_1.z.string().optional(),
       reasonCode: zod_1.z.string().optional(),
       reasonBreadcrumb: api_schemas_1.ReasonBreadcrumb.optional(),
+      // Reconstructed from station_window, which carries no note — filled in separately from the
+      // reason's downtime_event row (see DowntimeService.attachDowntimeNotes).
+      note: zod_1.z.string().optional(),
       range: time_1.TimeRange,
       lostProductionCost: zod_1.z.number().optional(),
       lostProductionQuantity: zod_1.z.number().optional(),
@@ -7195,6 +7224,7 @@ var require_downtime2 = __commonJS({
     exports2.DowntimeViewModel = schemas_1.DowntimeSchema.merge(zod_1.z.object({
       hasCause: zod_1.z.boolean(),
       reasonCode: zod_1.z.string().optional(),
+      note: zod_1.z.string().optional(),
       ragStatus: zod_1.z.nativeEnum(enums_1.RagStatus),
       stationName: zod_1.z.string().optional(),
       reasonBreadcrumb: zod_1.z.array(reason_1.ReasonViewModel),
@@ -7224,6 +7254,7 @@ var require_downtime2 = __commonJS({
       result.events.sort((a, b) => (0, moment_timezone_1.default)(b.createdAt).valueOf() - (0, moment_timezone_1.default)(a.createdAt).valueOf());
       const cause = result.events.find((event) => event.type === enums_1.DowntimeEventType.Cause);
       const causeCode = cause ? cause.causeCode : void 0;
+      const note = cause?.note || void 0;
       const hasCause = cause !== void 0;
       const startAtTimestamp = (0, moment_timezone_1.default)(result.startAt).valueOf();
       const endAtTimestamp = (0, moment_timezone_1.default)(result.endAt).valueOf();
@@ -7247,6 +7278,7 @@ var require_downtime2 = __commonJS({
         hasCause,
         ragStatus: getRagStatus(result),
         reasonCode: causeCode,
+        note,
         accountId: result.accountId,
         reasonBreadcrumb: [],
         startAtTimestamp,
@@ -7468,7 +7500,8 @@ var require_reason4 = __commonJS({
           code: reason.code,
           description: reason.description,
           type: reason.type,
-          parentReasonCode: parentReasonCode ?? null
+          parentReasonCode: parentReasonCode ?? null,
+          requireNotes: reason.requireNotes
         });
         if (reason.reasons?.length) {
           result.push(...flattenReasons(reason.reasons, reason.code));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "busroot-sdk",
-  "version": "0.0.8-dev.2708365288",
+  "version": "0.0.8-dev.2713878872",
   "description": "An SDK for accessing Busroot from output.industries",
   "homepage": "https://www.output.industries",
   "main": "./build/index.js",