@boboddy/sdk 0.1.43-alpha → 0.1.45-alpha

package/dist/client.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 {
@@ -895,6 +886,9 @@ class Projects extends HeyApiClient {
   getProject(options) {
     return (options.client ?? this.client).get({ url: "/api/projects/{projectId}", ...options });
   }
+  getProjectWorkItemSignalScores(options) {
+    return (options.client ?? this.client).get({ url: "/api/projects/{projectId}/work-item-signal-scores", ...options });
+  }
   updateProjectDefaultPipelineAssignment(options) {
     return (options.client ?? this.client).put({
       url: "/api/projects/{projectId}/default-pipeline-assignment",
@@ -1230,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
+      }
+    });
   }
 }
 
@@ -1287,6 +1310,43 @@ 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 });
+  }
+  listProjectInvites(options) {
+    return (options.client ?? this.client).get({ url: "/api/projects/{projectId}/invites", ...options });
+  }
+  createProjectInvite(options) {
+    return (options.client ?? this.client).post({
+      url: "/api/projects/{projectId}/invites",
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        ...options.headers
+      }
+    });
+  }
+  revokeProjectInvite(options) {
+    return (options.client ?? this.client).post({ url: "/api/projects/{projectId}/invites/{inviteId}/revoke", ...options });
+  }
+  acceptProjectInvite(options) {
+    return (options.client ?? this.client).post({ url: "/api/project-invites/{token}/accept", ...options });
+  }
+}
+
 class BoboddyClient extends HeyApiClient {
   static __registry = new HeyApiRegistry;
   constructor(args) {
@@ -1325,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() {
@@ -1337,6 +1401,14 @@ 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 });
+  }
 }
 // src/step-execution-plane-client.ts
 function createStepExecutionPlaneClient(baseUrl) {
@@ -1412,15 +1484,18 @@ export {
   createStepExecutionPlaneClient,
   createBoboddyClient,
   WorkItems,
+  UserNotifications,
   StepExecutions,
   StepDefinitions,
   StepDefinitionTemplates,
   Projects,
+  ProjectInvites,
   ProjectIntegrations,
   ProjectContext,
   PipelineExecutions,
   PipelineDefinitions,
-  FeedbackRequests,
+  NotificationRules,
+  GitHubIntegrations,
   BoboddyClient,
   Api
 };

package/dist/definitions/pipelines/index.js

@@ -15682,15 +15682,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 {
@@ -15713,6 +15704,9 @@ class Projects extends HeyApiClient {
   getProject(options) {
     return (options.client ?? this.client).get({ url: "/api/projects/{projectId}", ...options });
   }
+  getProjectWorkItemSignalScores(options) {
+    return (options.client ?? this.client).get({ url: "/api/projects/{projectId}/work-item-signal-scores", ...options });
+  }
   updateProjectDefaultPipelineAssignment(options) {
     return (options.client ?? this.client).put({
       url: "/api/projects/{projectId}/default-pipeline-assignment",
@@ -16048,12 +16042,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
+      }
+    });
   }
 }
 
@@ -16105,6 +16128,43 @@ 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 });
+  }
+  listProjectInvites(options) {
+    return (options.client ?? this.client).get({ url: "/api/projects/{projectId}/invites", ...options });
+  }
+  createProjectInvite(options) {
+    return (options.client ?? this.client).post({
+      url: "/api/projects/{projectId}/invites",
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        ...options.headers
+      }
+    });
+  }
+  revokeProjectInvite(options) {
+    return (options.client ?? this.client).post({ url: "/api/projects/{projectId}/invites/{inviteId}/revoke", ...options });
+  }
+  acceptProjectInvite(options) {
+    return (options.client ?? this.client).post({ url: "/api/project-invites/{token}/accept", ...options });
+  }
+}
+
 class BoboddyClient extends HeyApiClient {
   static __registry = new HeyApiRegistry;
   constructor(args) {
@@ -16143,9 +16203,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() {
@@ -16155,6 +16219,14 @@ 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 });
+  }
 }
 
 // src/definitions/pipelines/pipeline-definitions-client.ts

package/dist/definitions/steps/define-step.d.ts

@@ -1,5 +1,6 @@
 import type { ZodType } from "zod";
 import type { AnyStepFeature, FeatureResultExtensions, FeatureSignalKeys } from "./step-features";
+import { type PromptTemplateContext } from "./prompt-template";
 type OpenCodeMcpServers = Record<string, {
     type: "local";
     command: string[];
@@ -55,7 +56,7 @@ export type DefineStepInput<TInput extends ZodType = ZodType, TResult extends Zo
     name: string;
     description?: string | null;
     version?: number;
-    agentPrompt: string;
+    agentPrompt: string | ((context: PromptTemplateContext<TInput["_output"]>) => string);
     additionalInput?: TInput;
     result?: TResult;
     signals?: SignalSpecInput<TResult["_output"]>[];

package/dist/definitions/steps/index.js

@@ -11947,6 +11947,42 @@ class JSONSchemaGenerator {
 }
 // ../../../node_modules/.bun/zod@4.4.3/node_modules/zod/v4/core/json-schema.js
 var exports_json_schema = {};
+// src/definitions/steps/prompt-template.ts
+function createPromptInputProxy(path = []) {
+  const token = () => path.length ? `{{${path.join(".")}}}` : "";
+  return new Proxy(Object.freeze({}), {
+    get(_, key) {
+      if (key === Symbol.toPrimitive || key === "valueOf") {
+        return (_hint) => token();
+      }
+      if (key === "toString") {
+        return () => token();
+      }
+      if (typeof key !== "string")
+        return;
+      return createPromptInputProxy([...path, key]);
+    }
+  });
+}
+function createPromptTemplateContext() {
+  return {
+    input: createPromptInputProxy(["input"]),
+    env: createPromptInputProxy(["env"]),
+    boboddy: {
+      artifactsDir: createPromptInputProxy([
+        "boboddy",
+        "artifactsDir"
+      ])
+    }
+  };
+}
+function renderPromptTemplate(template, contextJson) {
+  return template.replace(/\{\{([^}]+)\}\}/g, (_, path) => {
+    const value = path.split(".").reduce((curr, key) => curr != null ? curr[key] : undefined, contextJson);
+    return value != null ? String(value) : "";
+  });
+}
+
 // src/definitions/steps/define-step.ts
 var UNWRAP_TYPES = new Set(["optional", "nullable", "default"]);
 function unwrapZodType(schema) {
@@ -11992,7 +12028,8 @@ function defineStep(config2) {
   for (const feature of features) {
     effectiveResult = effectiveResult ? effectiveResult.extend(feature._resultExtension.shape) : feature._resultExtension;
   }
-  let effectivePrompt = config2.agentPrompt;
+  const basePrompt = typeof config2.agentPrompt === "function" ? config2.agentPrompt(createPromptTemplateContext()) : config2.agentPrompt;
+  let effectivePrompt = basePrompt;
   for (const feature of features) {
     if (feature._promptAddition) {
       effectivePrompt = effectivePrompt ? `${effectivePrompt}
@@ -12032,29 +12069,6 @@ ${feature._promptAddition}` : feature._promptAddition;
   };
   return spec;
 }
-// src/definitions/steps/prompt-template.ts
-function createPromptInputProxy(path = []) {
-  const token = () => path.length ? `{{${path.join(".")}}}` : "";
-  return new Proxy(Object.freeze({}), {
-    get(_, key) {
-      if (key === Symbol.toPrimitive || key === "valueOf") {
-        return (_hint) => token();
-      }
-      if (key === "toString") {
-        return () => token();
-      }
-      if (typeof key !== "string")
-        return;
-      return createPromptInputProxy([...path, key]);
-    }
-  });
-}
-function renderPromptTemplate(template, inputJson) {
-  return template.replace(/\{\{([^}]+)\}\}/g, (_, path) => {
-    const value = path.split(".").reduce((curr, key) => curr != null ? curr[key] : undefined, inputJson);
-    return value != null ? String(value) : "";
-  });
-}
 // src/generated/core/bodySerializer.gen.ts
 var jsonBodySerializer = {
   bodySerializer: (body) => JSON.stringify(body, (_key, value) => typeof value === "bigint" ? value.toString() : value)
@@ -12905,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 {
@@ -12936,6 +12941,9 @@ class Projects extends HeyApiClient {
   getProject(options) {
     return (options.client ?? this.client).get({ url: "/api/projects/{projectId}", ...options });
   }
+  getProjectWorkItemSignalScores(options) {
+    return (options.client ?? this.client).get({ url: "/api/projects/{projectId}/work-item-signal-scores", ...options });
+  }
   updateProjectDefaultPipelineAssignment(options) {
     return (options.client ?? this.client).put({
       url: "/api/projects/{projectId}/default-pipeline-assignment",
@@ -13271,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
+      }
+    });
   }
 }
 
@@ -13328,6 +13365,43 @@ 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 });
+  }
+  listProjectInvites(options) {
+    return (options.client ?? this.client).get({ url: "/api/projects/{projectId}/invites", ...options });
+  }
+  createProjectInvite(options) {
+    return (options.client ?? this.client).post({
+      url: "/api/projects/{projectId}/invites",
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        ...options.headers
+      }
+    });
+  }
+  revokeProjectInvite(options) {
+    return (options.client ?? this.client).post({ url: "/api/projects/{projectId}/invites/{inviteId}/revoke", ...options });
+  }
+  acceptProjectInvite(options) {
+    return (options.client ?? this.client).post({ url: "/api/project-invites/{token}/accept", ...options });
+  }
+}
+
 class BoboddyClient extends HeyApiClient {
   static __registry = new HeyApiRegistry;
   constructor(args) {
@@ -13366,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() {
@@ -13378,6 +13456,14 @@ 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 });
+  }
 }
 
 // src/definitions/steps/step-definitions-client.ts
@@ -15765,67 +15851,73 @@ 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
+    }
   })
 };
 export {
   renderPromptTemplate,
   defineStep,
   createStepDefinitionsClient,
+  createPromptTemplateContext,
   createPromptInputProxy,
   Features
 };