@databutton/firebase-types 1.150.0 → 1.151.0

package/lib/types/published/enums.d.ts

@@ -307,5 +307,6 @@ export declare enum AccountEmployeeCount {
     COUNT_5000_PLUS = "5000+"
 }
 export declare enum NotificationType {
-    AGENT_TASK_REQUIRE_INPUT = "agent-task-require-input"
+    AGENT_TASK_REQUIRE_INPUT = "agent-task-require-input",
+    AGENT_SUGGEST_NEXT_STEPS = "agent-suggest-next-steps"
 }

package/lib/types/published/enums.js

@@ -339,5 +339,6 @@ export var AccountEmployeeCount;
 export var NotificationType;
 (function (NotificationType) {
     NotificationType["AGENT_TASK_REQUIRE_INPUT"] = "agent-task-require-input";
+    NotificationType["AGENT_SUGGEST_NEXT_STEPS"] = "agent-suggest-next-steps";
 })(NotificationType || (NotificationType = {}));
 //# sourceMappingURL=enums.js.map

package/lib/types/published/persisted.d.ts

@@ -1,7 +1,8 @@
 import type { Timestamp } from "firebase/firestore";
 import type { JsonObject, Primitive } from "type-fest";
 import type { ProjectMigration } from "../internal/enums.js";
-import type { AccountBusinessModel, AccountEmployeeCount, AccountIndustry, AccountRole, ConfigTypes, ImprovementPriority, ImprovementStatus, NotificationType, TaskPriority, TaskRelation, ThirdPartyAuthName, ThirdPartyDatabaseName, ThirdPartyPaymentsName, ThirdPartyServiceCategory, ThirdPartyStorageName, UiComponentTag } from "./enums.js";
+import { NotificationType } from "./enums.js";
+import type { AccountBusinessModel, AccountEmployeeCount, AccountIndustry, AccountRole, ConfigTypes, ImprovementPriority, ImprovementStatus, TaskPriority, TaskRelation, ThirdPartyAuthName, ThirdPartyDatabaseName, ThirdPartyPaymentsName, ThirdPartyServiceCategory, ThirdPartyStorageName, UiComponentTag } from "./enums.js";
 /**
  * Types here should reflect data format stored in firestore and
  * either be backwards-compatible or migrated when needed
@@ -47,12 +48,15 @@ export interface SubscribedNotificationGroup {
     groupId: string;
     mode: NotificationGroupMode;
 }
-export interface Notification {
+interface NotificationBase {
     createdBy: PerformedBy;
     createdAt: Timestamp;
     userId: string | null;
     groupId: string | null;
     read: boolean;
+}
+/** A tool call is awaiting human approval. */
+export interface NotificationForApproval extends NotificationBase {
     type: NotificationType.AGENT_TASK_REQUIRE_INPUT;
     metadata: {
         projectId: string;
@@ -68,6 +72,27 @@ export interface Notification {
         environment?: "dev" | "prod" | null;
     };
 }
+/**
+ * The agent reached a natural stop point and is asking the human for input
+ * (via the suggest_next_steps tool). The suggested options live on the tool
+ * call in the session, not on the notification.
+ */
+export interface NotificationForSuggestNextSteps extends NotificationBase {
+    type: NotificationType.AGENT_SUGGEST_NEXT_STEPS;
+    metadata: {
+        projectId: string;
+        title: string;
+        description: string;
+        sessionId: string;
+        taskId?: string | null;
+        displayId?: string | null;
+        taskTitle?: string | null;
+        environment?: "dev" | "prod" | null;
+    };
+}
+export type Notification = NotificationForApproval | NotificationForSuggestNextSteps;
+export declare function isApprovalNotification(notification: Notification): notification is NotificationForApproval;
+export declare function isSuggestNextStepsNotification(notification: Notification): notification is NotificationForSuggestNextSteps;
 export interface PublicUsername {
     username: string;
     slug: string;

package/lib/types/published/persisted.js

@@ -1,3 +1,12 @@
+// NotificationType is imported as a value (not `import type`) because the
+// notification type guards below compare against its members at runtime.
+import { NotificationType } from "./enums.js";
+export function isApprovalNotification(notification) {
+    return notification.type === NotificationType.AGENT_TASK_REQUIRE_INPUT;
+}
+export function isSuggestNextStepsNotification(notification) {
+    return notification.type === NotificationType.AGENT_SUGGEST_NEXT_STEPS;
+}
 export var FrontendBuildStage;
 (function (FrontendBuildStage) {
     FrontendBuildStage["PROTOTYPE"] = "prototype";

package/lib/types/published/requests.d.ts

@@ -1,6 +1,6 @@
 import type { Timestamp } from "firebase/firestore";
 import type { RunMigrationsResponse } from "../db-api.js";
-import type { CreateNeonTransferErrorCode, CreateProjectErrorCode, CreateStackAuthTransferErrorCode, CreateTeamAccountErrorCode, MigrateToRiffErrorCode } from "./enums.js";
+import type { CreateNeonTransferErrorCode, CreateProjectErrorCode, CreateStackAuthTransferErrorCode, CreateTeamAccountErrorCode, MigrateToRiffErrorCode, NotificationType } from "./enums.js";
 import type { ApprovalLevel, Datafile, Dataframe, Job, Project, ProjectPermissionName, ProjectTemplate, ScheduleTarget, ScheduleWhen } from "./persisted.js";
 export type DeleteJob = Pick<Job, "markedForDeletionAt" | "markedForDeletionBy">;
 export type DeleteProject = Pick<Project, "markedForDeletionAt" | "markedForDeletionBy">;
@@ -575,21 +575,29 @@ export type RegisterSlackAppResponse = {
     errorCode: string;
     errorMessage?: string;
 };
-export type CreateApprovalNotificationRequest = {
+/**
+ * Request for the single agent-notification callable. `type` selects the
+ * notification kind (defaults to AGENT_TASK_REQUIRE_INPUT / approval when
+ * omitted). Type-specific fields are optional: approval uses `toolName` /
+ * `reason` / `messageSequence` / `toolUseId`; suggest-next-steps uses `message`.
+ */
+export type CreateNotificationRequest = {
+    type?: NotificationType | null;
     projectId: string;
     accountId: string;
     userId: string | null;
-    toolName: string;
     sessionId: string;
-    messageSequence?: string | null;
-    toolUseId?: string | null;
     taskId?: string | null;
     displayId?: string | null;
-    reason?: string | null;
     taskTitle?: string | null;
     environment?: "dev" | "prod" | null;
+    toolName?: string | null;
+    reason?: string | null;
+    messageSequence?: string | null;
+    toolUseId?: string | null;
+    message?: string | null;
 };
-export type CreateApprovalNotificationResponse = {
+export type CreateNotificationResponse = {
     notificationId: string;
 };
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@databutton/firebase-types",
-  "version": "1.150.0",
+  "version": "1.151.0",
   "main": "lib/types/published/index.js",
   "type": "module",
   "engines": {