@boboddy/sdk 0.1.44-alpha → 0.1.45-alpha

package/dist/index.js

@@ -864,15 +864,6 @@ class Api extends HeyApiClient {
   "allApiAuth*8"(options) {
     return (options?.client ?? this.client).trace({ url: "/api/auth/*", ...options });
   }
-  getApiIntegrationsGithubInstall(options) {
-    return (options?.client ?? this.client).get({ url: "/api/integrations/github/install", ...options });
-  }
-  getApiIntegrationsGithubCallback(options) {
-    return (options?.client ?? this.client).get({ url: "/api/integrations/github/callback", ...options });
-  }
-  postApiIntegrationsGithubWebhook(options) {
-    return (options?.client ?? this.client).post({ url: "/api/integrations/github/webhook", ...options });
-  }
 }
 
 class Projects extends HeyApiClient {
@@ -1233,12 +1224,41 @@ class ProjectContext extends HeyApiClient {
   }
 }
 
-class FeedbackRequests extends HeyApiClient {
-  listFeedbackRequests(options) {
-    return (options.client ?? this.client).get({ url: "/api/projects/{projectId}/step-signals/{stepSignalId}/feedback-requests", ...options });
+class UserNotifications extends HeyApiClient {
+  listUserNotifications(options) {
+    return (options.client ?? this.client).get({ url: "/api/projects/{projectId}/notifications", ...options });
+  }
+  getUserNotification(options) {
+    return (options.client ?? this.client).get({ url: "/api/projects/{projectId}/notifications/{notificationId}", ...options });
+  }
+  dismissUserNotification(options) {
+    return (options.client ?? this.client).post({ url: "/api/projects/{projectId}/notifications/{notificationId}/dismiss", ...options });
+  }
+  respondToFeedbackRequest(options) {
+    return (options.client ?? this.client).post({
+      url: "/api/projects/{projectId}/notifications/{notificationId}/respond",
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        ...options.headers
+      }
+    });
+  }
+}
+
+class NotificationRules extends HeyApiClient {
+  listNotificationRules(options) {
+    return (options.client ?? this.client).get({ url: "/api/projects/{projectId}/notification-rules", ...options });
   }
-  declineFeedbackRequest(options) {
-    return (options.client ?? this.client).post({ url: "/api/projects/{projectId}/feedback-requests/{feedbackRequestId}/decline", ...options });
+  upsertNotificationRule(options) {
+    return (options.client ?? this.client).put({
+      url: "/api/projects/{projectId}/notification-rules",
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        ...options.headers
+      }
+    });
   }
 }
 
@@ -1290,6 +1310,18 @@ class ProjectIntegrations extends HeyApiClient {
   }
 }
 
+class GitHubIntegrations extends HeyApiClient {
+  beginGitHubAppInstall(options) {
+    return (options?.client ?? this.client).get({ url: "/api/integrations/github/install", ...options });
+  }
+  completeGitHubAppInstall(options) {
+    return (options?.client ?? this.client).get({ url: "/api/integrations/github/callback", ...options });
+  }
+  handleGitHubWebhook(options) {
+    return (options?.client ?? this.client).post({ url: "/api/integrations/github/webhook", ...options });
+  }
+}
+
 class ProjectInvites extends HeyApiClient {
   getProjectInviteByToken(options) {
     return (options.client ?? this.client).get({ url: "/api/project-invites/{token}", ...options });
@@ -1353,9 +1385,13 @@ class BoboddyClient extends HeyApiClient {
   get projectContext() {
     return this._projectContext ??= new ProjectContext({ client: this.client });
   }
-  _feedbackRequests;
-  get feedbackRequests() {
-    return this._feedbackRequests ??= new FeedbackRequests({ client: this.client });
+  _userNotifications;
+  get userNotifications() {
+    return this._userNotifications ??= new UserNotifications({ client: this.client });
+  }
+  _notificationRules;
+  get notificationRules() {
+    return this._notificationRules ??= new NotificationRules({ client: this.client });
   }
   _stepDefinitionTemplates;
   get stepDefinitionTemplates() {
@@ -1365,6 +1401,10 @@ class BoboddyClient extends HeyApiClient {
   get projectIntegrations() {
     return this._projectIntegrations ??= new ProjectIntegrations({ client: this.client });
   }
+  _gitHubIntegrations;
+  get gitHubIntegrations() {
+    return this._gitHubIntegrations ??= new GitHubIntegrations({ client: this.client });
+  }
   _projectInvites;
   get projectInvites() {
     return this._projectInvites ??= new ProjectInvites({ client: this.client });
@@ -15881,61 +15921,66 @@ function date4(params) {
 // ../../../node_modules/.bun/zod@4.4.3/node_modules/zod/v4/classic/external.js
 config(en_default());
 // src/definitions/steps/step-features.ts
-var FEEDBACK_REQUEST_SIGNAL_KEY = "$boboddy_feedback_request_v1";
-var FEEDBACK_REQUEST_RESULT_KEY = "$boboddy_feedbackRequests_v1";
-var feedbackRequestItemSchema = exports_external.object({
-  question: exports_external.string().describe("The specific question to pose to a human reviewer."),
-  category: exports_external.string().describe('A grouping label for the feedback (e.g. "accuracy", "completeness").'),
-  urgency: exports_external.enum(["blocking", "clarification", "assumption", "informational"]).describe([
-    "How urgently a human response is needed:",
-    '- "blocking": cannot proceed at all without an answer.',
-    '- "clarification": genuinely ambiguous \u2014 unsure how to interpret, but not fully blocked.',
-    '- "assumption": proceeded with a guess; please verify the assumption.',
-    '- "informational": FYI only \u2014 agent proceeded fine and no reply is required.'
-  ].join(`
-`)),
-  suggestedKey: exports_external.string().optional().describe("An optional suggested answer key for reference.")
-}).describe("A single feedback request item for human review.");
-var feedbackRequestsFeature = {
+var NOTIFICATION_SIGNAL_KEY = "$boboddy_notifications_v1";
+var NOTIFICATION_RESULT_KEY = "$boboddy_notifications_v1";
+var notificationItemSchema = exports_external.object({
+  kind: exports_external.enum([
+    "feedback_request",
+    "status_update",
+    "blocked",
+    "result_ready",
+    "warning"
+  ]).describe("The kind of user notification."),
+  title: exports_external.string().describe("Short, human-readable notification title."),
+  body: exports_external.string().describe("The notification body / details."),
+  priority: exports_external.enum(["low", "normal", "high", "urgent"]).describe("How important this notification is for the user."),
+  suggestedChannels: exports_external.array(exports_external.enum(["in_app", "jira_comment", "email", "slack"])).optional().describe("Channels the agent thinks are worth using. The platform policy decides the final channels."),
+  payload: exports_external.record(exports_external.string(), exports_external.unknown()).optional().describe('Kind-specific structured data. For "feedback_request": { category, urgency, suggestedKey? }.')
+}).describe("A single user notification emitted by the agent.");
+var notificationsFeature = {
   _resultExtension: exports_external.object({
-    [FEEDBACK_REQUEST_RESULT_KEY]: exports_external.array(feedbackRequestItemSchema).optional()
+    [NOTIFICATION_RESULT_KEY]: exports_external.array(notificationItemSchema).optional()
   }),
   _promptAddition: [
-    "## Feedback Requests",
+    "## User Notifications",
     "",
-    `If you encounter anything that warrants human review, populate the \`${FEEDBACK_REQUEST_RESULT_KEY}\` array.`,
+    `If you need to communicate something to a human, populate the \`${NOTIFICATION_RESULT_KEY}\` array.`,
     "Each item must include:",
-    "- **question**: The specific question to pose to a human reviewer.",
-    '- **category**: A grouping label for the feedback (e.g. `"accuracy"`, `"completeness"`).',
-    "- **urgency**: How urgently a human response is needed. Must be one of:",
-    '  - `"blocking"`: Cannot proceed at all without an answer.',
-    '  - `"clarification"`: Genuinely ambiguous \u2014 unsure how to interpret, but not fully blocked.',
-    '  - `"assumption"`: Proceeded with a guess; please verify the assumption.',
-    '  - `"informational"`: FYI only \u2014 agent proceeded fine and no reply is required.',
-    "- **suggestedKey** *(optional)*: A suggested answer key for reference."
+    "- **kind**: One of `feedback_request`, `status_update`, `blocked`, `result_ready`, `warning`.",
+    "- **title**: A short, human-readable title.",
+    "- **body**: The details of the notification.",
+    "- **priority**: One of `low`, `normal`, `high`, `urgent`.",
+    '- **suggestedChannels** *(optional)*: Channels you think are worth using (e.g. `["in_app", "jira_comment"]`).',
+    "  You only *suggest* channels \u2014 the platform policy decides the final delivery channels.",
+    '- **payload** *(optional)*: Kind-specific data. For `feedback_request`, include `{ "category": string, "urgency": "blocking"|"clarification"|"assumption"|"informational", "suggestedKey"?: string }`.'
   ].join(`
 `),
   _signals: [
     {
-      key: FEEDBACK_REQUEST_SIGNAL_KEY,
-      sourcePath: FEEDBACK_REQUEST_RESULT_KEY,
+      key: NOTIFICATION_SIGNAL_KEY,
+      sourcePath: NOTIFICATION_RESULT_KEY,
       type: "array",
       required: false
     }
   ]
 };
 var Features = {
-  feedbackRequests: Object.assign(() => feedbackRequestsFeature, {
+  notifications: Object.assign(() => notificationsFeature, {
     signal: {
-      key: FEEDBACK_REQUEST_SIGNAL_KEY,
+      key: NOTIFICATION_SIGNAL_KEY,
       find(signals) {
-        const match = signals.find((s) => s.key === FEEDBACK_REQUEST_SIGNAL_KEY);
+        const match = signals.find((s) => s.key === NOTIFICATION_SIGNAL_KEY);
         if (!match)
           return;
-        const parsed = exports_external.array(feedbackRequestItemSchema).safeParse(match.valueJson);
+        const parsed = exports_external.array(notificationItemSchema).safeParse(match.valueJson);
         return parsed.success ? parsed.data : undefined;
       }
     }
+  }),
+  feedbackRequests: Object.assign(() => notificationsFeature, {
+    signal: {
+      key: NOTIFICATION_SIGNAL_KEY
+    }
   })
 };
 // src/definitions/advancement-policies/define-advancement-policy.ts
@@ -17023,6 +17068,7 @@ export {
   createBoboddyClient,
   buildPipelineSpec,
   WorkItems,
+  UserNotifications,
   StepExecutions,
   StepDefinitions,
   StepDefinitionTemplates,
@@ -17036,7 +17082,8 @@ export {
   PipelineExecutions,
   PipelineDefinitions,
   PipelineBuilder,
-  FeedbackRequests,
+  NotificationRules,
+  GitHubIntegrations,
   Features,
   DEFAULT_PIPELINE_ASSIGNMENT_FILENAME,
   Computed,

package/dist/push/index.js

@@ -12919,15 +12919,6 @@ class Api extends HeyApiClient {
   "allApiAuth*8"(options) {
     return (options?.client ?? this.client).trace({ url: "/api/auth/*", ...options });
   }
-  getApiIntegrationsGithubInstall(options) {
-    return (options?.client ?? this.client).get({ url: "/api/integrations/github/install", ...options });
-  }
-  getApiIntegrationsGithubCallback(options) {
-    return (options?.client ?? this.client).get({ url: "/api/integrations/github/callback", ...options });
-  }
-  postApiIntegrationsGithubWebhook(options) {
-    return (options?.client ?? this.client).post({ url: "/api/integrations/github/webhook", ...options });
-  }
 }
 
 class Projects extends HeyApiClient {
@@ -13288,12 +13279,41 @@ class ProjectContext extends HeyApiClient {
   }
 }
 
-class FeedbackRequests extends HeyApiClient {
-  listFeedbackRequests(options) {
-    return (options.client ?? this.client).get({ url: "/api/projects/{projectId}/step-signals/{stepSignalId}/feedback-requests", ...options });
+class UserNotifications extends HeyApiClient {
+  listUserNotifications(options) {
+    return (options.client ?? this.client).get({ url: "/api/projects/{projectId}/notifications", ...options });
+  }
+  getUserNotification(options) {
+    return (options.client ?? this.client).get({ url: "/api/projects/{projectId}/notifications/{notificationId}", ...options });
+  }
+  dismissUserNotification(options) {
+    return (options.client ?? this.client).post({ url: "/api/projects/{projectId}/notifications/{notificationId}/dismiss", ...options });
+  }
+  respondToFeedbackRequest(options) {
+    return (options.client ?? this.client).post({
+      url: "/api/projects/{projectId}/notifications/{notificationId}/respond",
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        ...options.headers
+      }
+    });
+  }
+}
+
+class NotificationRules extends HeyApiClient {
+  listNotificationRules(options) {
+    return (options.client ?? this.client).get({ url: "/api/projects/{projectId}/notification-rules", ...options });
   }
-  declineFeedbackRequest(options) {
-    return (options.client ?? this.client).post({ url: "/api/projects/{projectId}/feedback-requests/{feedbackRequestId}/decline", ...options });
+  upsertNotificationRule(options) {
+    return (options.client ?? this.client).put({
+      url: "/api/projects/{projectId}/notification-rules",
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        ...options.headers
+      }
+    });
   }
 }
 
@@ -13345,6 +13365,18 @@ class ProjectIntegrations extends HeyApiClient {
   }
 }
 
+class GitHubIntegrations extends HeyApiClient {
+  beginGitHubAppInstall(options) {
+    return (options?.client ?? this.client).get({ url: "/api/integrations/github/install", ...options });
+  }
+  completeGitHubAppInstall(options) {
+    return (options?.client ?? this.client).get({ url: "/api/integrations/github/callback", ...options });
+  }
+  handleGitHubWebhook(options) {
+    return (options?.client ?? this.client).post({ url: "/api/integrations/github/webhook", ...options });
+  }
+}
+
 class ProjectInvites extends HeyApiClient {
   getProjectInviteByToken(options) {
     return (options.client ?? this.client).get({ url: "/api/project-invites/{token}", ...options });
@@ -13408,9 +13440,13 @@ class BoboddyClient extends HeyApiClient {
   get projectContext() {
     return this._projectContext ??= new ProjectContext({ client: this.client });
   }
-  _feedbackRequests;
-  get feedbackRequests() {
-    return this._feedbackRequests ??= new FeedbackRequests({ client: this.client });
+  _userNotifications;
+  get userNotifications() {
+    return this._userNotifications ??= new UserNotifications({ client: this.client });
+  }
+  _notificationRules;
+  get notificationRules() {
+    return this._notificationRules ??= new NotificationRules({ client: this.client });
   }
   _stepDefinitionTemplates;
   get stepDefinitionTemplates() {
@@ -13420,6 +13456,10 @@ class BoboddyClient extends HeyApiClient {
   get projectIntegrations() {
     return this._projectIntegrations ??= new ProjectIntegrations({ client: this.client });
   }
+  _gitHubIntegrations;
+  get gitHubIntegrations() {
+    return this._gitHubIntegrations ??= new GitHubIntegrations({ client: this.client });
+  }
   _projectInvites;
   get projectInvites() {
     return this._projectInvites ??= new ProjectInvites({ client: this.client });
@@ -15811,61 +15851,66 @@ function date4(params) {
 // ../../../node_modules/.bun/zod@4.4.3/node_modules/zod/v4/classic/external.js
 config(en_default());
 // src/definitions/steps/step-features.ts
-var FEEDBACK_REQUEST_SIGNAL_KEY = "$boboddy_feedback_request_v1";
-var FEEDBACK_REQUEST_RESULT_KEY = "$boboddy_feedbackRequests_v1";
-var feedbackRequestItemSchema = exports_external.object({
-  question: exports_external.string().describe("The specific question to pose to a human reviewer."),
-  category: exports_external.string().describe('A grouping label for the feedback (e.g. "accuracy", "completeness").'),
-  urgency: exports_external.enum(["blocking", "clarification", "assumption", "informational"]).describe([
-    "How urgently a human response is needed:",
-    '- "blocking": cannot proceed at all without an answer.',
-    '- "clarification": genuinely ambiguous \u2014 unsure how to interpret, but not fully blocked.',
-    '- "assumption": proceeded with a guess; please verify the assumption.',
-    '- "informational": FYI only \u2014 agent proceeded fine and no reply is required.'
-  ].join(`
-`)),
-  suggestedKey: exports_external.string().optional().describe("An optional suggested answer key for reference.")
-}).describe("A single feedback request item for human review.");
-var feedbackRequestsFeature = {
+var NOTIFICATION_SIGNAL_KEY = "$boboddy_notifications_v1";
+var NOTIFICATION_RESULT_KEY = "$boboddy_notifications_v1";
+var notificationItemSchema = exports_external.object({
+  kind: exports_external.enum([
+    "feedback_request",
+    "status_update",
+    "blocked",
+    "result_ready",
+    "warning"
+  ]).describe("The kind of user notification."),
+  title: exports_external.string().describe("Short, human-readable notification title."),
+  body: exports_external.string().describe("The notification body / details."),
+  priority: exports_external.enum(["low", "normal", "high", "urgent"]).describe("How important this notification is for the user."),
+  suggestedChannels: exports_external.array(exports_external.enum(["in_app", "jira_comment", "email", "slack"])).optional().describe("Channels the agent thinks are worth using. The platform policy decides the final channels."),
+  payload: exports_external.record(exports_external.string(), exports_external.unknown()).optional().describe('Kind-specific structured data. For "feedback_request": { category, urgency, suggestedKey? }.')
+}).describe("A single user notification emitted by the agent.");
+var notificationsFeature = {
   _resultExtension: exports_external.object({
-    [FEEDBACK_REQUEST_RESULT_KEY]: exports_external.array(feedbackRequestItemSchema).optional()
+    [NOTIFICATION_RESULT_KEY]: exports_external.array(notificationItemSchema).optional()
   }),
   _promptAddition: [
-    "## Feedback Requests",
+    "## User Notifications",
     "",
-    `If you encounter anything that warrants human review, populate the \`${FEEDBACK_REQUEST_RESULT_KEY}\` array.`,
+    `If you need to communicate something to a human, populate the \`${NOTIFICATION_RESULT_KEY}\` array.`,
     "Each item must include:",
-    "- **question**: The specific question to pose to a human reviewer.",
-    '- **category**: A grouping label for the feedback (e.g. `"accuracy"`, `"completeness"`).',
-    "- **urgency**: How urgently a human response is needed. Must be one of:",
-    '  - `"blocking"`: Cannot proceed at all without an answer.',
-    '  - `"clarification"`: Genuinely ambiguous \u2014 unsure how to interpret, but not fully blocked.',
-    '  - `"assumption"`: Proceeded with a guess; please verify the assumption.',
-    '  - `"informational"`: FYI only \u2014 agent proceeded fine and no reply is required.',
-    "- **suggestedKey** *(optional)*: A suggested answer key for reference."
+    "- **kind**: One of `feedback_request`, `status_update`, `blocked`, `result_ready`, `warning`.",
+    "- **title**: A short, human-readable title.",
+    "- **body**: The details of the notification.",
+    "- **priority**: One of `low`, `normal`, `high`, `urgent`.",
+    '- **suggestedChannels** *(optional)*: Channels you think are worth using (e.g. `["in_app", "jira_comment"]`).',
+    "  You only *suggest* channels \u2014 the platform policy decides the final delivery channels.",
+    '- **payload** *(optional)*: Kind-specific data. For `feedback_request`, include `{ "category": string, "urgency": "blocking"|"clarification"|"assumption"|"informational", "suggestedKey"?: string }`.'
   ].join(`
 `),
   _signals: [
     {
-      key: FEEDBACK_REQUEST_SIGNAL_KEY,
-      sourcePath: FEEDBACK_REQUEST_RESULT_KEY,
+      key: NOTIFICATION_SIGNAL_KEY,
+      sourcePath: NOTIFICATION_RESULT_KEY,
       type: "array",
       required: false
     }
   ]
 };
 var Features = {
-  feedbackRequests: Object.assign(() => feedbackRequestsFeature, {
+  notifications: Object.assign(() => notificationsFeature, {
     signal: {
-      key: FEEDBACK_REQUEST_SIGNAL_KEY,
+      key: NOTIFICATION_SIGNAL_KEY,
       find(signals) {
-        const match = signals.find((s) => s.key === FEEDBACK_REQUEST_SIGNAL_KEY);
+        const match = signals.find((s) => s.key === NOTIFICATION_SIGNAL_KEY);
         if (!match)
           return;
-        const parsed = exports_external.array(feedbackRequestItemSchema).safeParse(match.valueJson);
+        const parsed = exports_external.array(notificationItemSchema).safeParse(match.valueJson);
         return parsed.success ? parsed.data : undefined;
       }
     }
+  }),
+  feedbackRequests: Object.assign(() => notificationsFeature, {
+    signal: {
+      key: NOTIFICATION_SIGNAL_KEY
+    }
   })
 };
 // src/definitions/advancement-policies/define-advancement-policy.ts

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@boboddy/sdk",
-  "version": "0.1.44-alpha",
+  "version": "0.1.45-alpha",
   "type": "module",
   "exports": {
     ".": {