@butlerbot/sdk 0.0.40 → 0.0.41

package/dist/types/outreach/delivery.d.ts

@@ -39,6 +39,13 @@ export type DeliveryClosed = {
     at: number;
     reason: DeliveryClosedReason;
 };
+export declare const DELIVERY_SOURCES: readonly ["shift", "runtime", "gate"];
+/**
+ * Who wrote the delivery: a job shift asking with `reach_user`, the runtime telling the user
+ * where a job stands, or the autonomy gate asking for an approval. Only a shift's own ask
+ * holds a finished job open until it is answered.
+ */
+export type DeliverySource = typeof DELIVERY_SOURCES[number];
 export type DeliveryAnswer = {
     at: number;
     text: string;
@@ -69,6 +76,8 @@ export type Delivery = {
      * 409 the same way it does one already answered.
      */
     closed: DeliveryClosed | null;
+    /** Who wrote it. Rows from before this was recorded read as `runtime`. */
+    source: DeliverySource;
     created: number;
 };
 /** Whether a delivery is still waiting on the user: unanswered, and not closed under it. */

package/dist/types/outreach/delivery.js

@@ -7,7 +7,7 @@
  * on that job's inbox.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DELIVERY_CLOSED_REASONS = exports.DELIVERY_ANSWER_VIA = exports.DELIVERY_SURFACE_STATUSES = exports.DELIVERY_SURFACES = exports.ANSWERABLE_DELIVERY_INTENTS = exports.DELIVERY_INTENTS = void 0;
+exports.DELIVERY_SOURCES = exports.DELIVERY_CLOSED_REASONS = exports.DELIVERY_ANSWER_VIA = exports.DELIVERY_SURFACE_STATUSES = exports.DELIVERY_SURFACES = exports.ANSWERABLE_DELIVERY_INTENTS = exports.DELIVERY_INTENTS = void 0;
 exports.isDeliveryOpen = isDeliveryOpen;
 exports.DELIVERY_INTENTS = ["question", "update", "approval", "statement"];
 /** The intents that leave something outstanding until the user answers. */
@@ -16,6 +16,7 @@ exports.DELIVERY_SURFACES = ["web", "discord"];
 exports.DELIVERY_SURFACE_STATUSES = ["pending", "sent", "failed"];
 exports.DELIVERY_ANSWER_VIA = ["web", "discord", "chat", "tool"];
 exports.DELIVERY_CLOSED_REASONS = ["job_done", "job_failed", "job_cancelled"];
+exports.DELIVERY_SOURCES = ["shift", "runtime", "gate"];
 /** Whether a delivery is still waiting on the user: unanswered, and not closed under it. */
 function isDeliveryOpen(delivery) {
     return exports.ANSWERABLE_DELIVERY_INTENTS.includes(delivery.intent) && !delivery.answered && !delivery.closed;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@butlerbot/sdk",
-	"version": "0.0.40",
+	"version": "0.0.41",
 	"description": "The official ButlerBot SDK",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",

package/readme.md

@@ -383,7 +383,9 @@ it. An approval takes `decision: "approve" | "deny"` alongside the text.
 
 A delivery whose job ended before anyone answered is closed instead: `closed` carries the time
 and a reason of `job_done`, `job_failed` or `job_cancelled`. `isDeliveryOpen` reads false for
-one, and answering it is refused with a 409 just as one already answered is.
+one, and answering it is refused with a 409 just as one already answered is. `source` says who
+wrote a delivery: `shift` for a question a job's shift asked, `runtime` for the job's own
+status tells, `gate` for an approval the autonomy gate asked for.
 
 ### When a call fails