@boboddy/sdk 0.1.8-alpha → 0.1.10-alpha

package/dist/definitions/advancement-policies/define-advancement-policy.d.ts

@@ -51,7 +51,12 @@ export declare const Computed: {
  */
 export type ConditionOperator = "equal" | "notEqual" | "lessThan" | "lessThanInclusive" | "greaterThan" | "greaterThanInclusive" | "in" | "notIn" | "contains" | "doesNotContain";
 /** All possible outcomes a step can resolve to after policy evaluation. */
-export type AdvancementEventType = "continue" | "block" | "needs_review" | "complete";
+export type AdvancementEventType = "continue" | "block" | "route" | "complete";
+export type RouteOutcome = {
+    outcome: "route";
+    pipelineKey: string;
+    inputJson?: Record<string, unknown> | null;
+};
 /**
  * The outcome emitted when a rule fires (or when no rules match and
  * `defaultOutcome` is used).
@@ -59,14 +64,10 @@ export type AdvancementEventType = "continue" | "block" | "needs_review" | "comp
  * Shorthand — use when no extra params are needed:
  *   "continue"
  *
- * Object form — use when the outcome carries additional context the runtime
- * or downstream steps should receive:
- *   { outcome: "needs_review", outcomeJson: { reason: "low confidence" } }
+ * Route to another pipeline:
+ *   { outcome: "route", pipelineKey: "other-pipeline" }
  */
-export type AdvancementOutcome = AdvancementEventType | {
-    outcome: AdvancementEventType;
-    outcomeJson?: Record<string, unknown> | null;
-};
+export type AdvancementOutcome = Exclude<AdvancementEventType, "route"> | RouteOutcome;
 /**
  * A leaf condition that checks a single signal value against a given operator
  * and value. Used directly inside `Rule.all()` / `Rule.any()`, or implicitly

package/dist/definitions/advancement-policies/index.js

@@ -63,7 +63,13 @@ function resolveOutcome(outcome) {
   if (typeof outcome === "string") {
     return { type: outcome, params: null };
   }
-  return { type: outcome.outcome, params: outcome.outcomeJson ?? null };
+  return {
+    type: "route",
+    params: {
+      pipelineKey: outcome.pipelineKey,
+      ...outcome.inputJson != null ? { inputJson: outcome.inputJson } : {}
+    }
+  };
 }
 function serializeCondition(condition) {
   if (condition._tag === "signal") {

package/dist/definitions/pipelines/index.js

@@ -63,7 +63,13 @@ function resolveOutcome(outcome) {
   if (typeof outcome === "string") {
     return { type: outcome, params: null };
   }
-  return { type: outcome.outcome, params: outcome.outcomeJson ?? null };
+  return {
+    type: "route",
+    params: {
+      pipelineKey: outcome.pipelineKey,
+      ...outcome.inputJson != null ? { inputJson: outcome.inputJson } : {}
+    }
+  };
 }
 function serializeCondition(condition) {
   if (condition._tag === "signal") {

package/dist/definitions/steps/index.js

@@ -15685,28 +15685,43 @@ function date4(params) {
 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(),
-  category: exports_external.string(),
-  suggestedKey: exports_external.string().optional()
-});
+  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 — unsure how to interpret, but not fully blocked.',
+    '- "assumption": proceeded with a guess; please verify the assumption.',
+    '- "informational": FYI only — 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 = {
   _resultExtension: exports_external.object({
-    feedbackRequests: exports_external.array(feedbackRequestItemSchema).optional()
+    [FEEDBACK_REQUEST_RESULT_KEY]: exports_external.array(feedbackRequestItemSchema).optional()
   }),
   _promptAddition: [
     "## Feedback Requests",
     "",
-    "If you encounter anything that warrants human review, populate the `feedbackRequests` array:",
-    "- **question**: The specific question to pose to a human reviewer",
-    '- **category**: A grouping label for the feedback (e.g. `"accuracy"`, `"completeness"`)',
-    "- **suggestedKey** *(optional)*: A suggested answer key for reference"
+    `If you encounter anything that warrants human review, populate the \`${FEEDBACK_REQUEST_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 — unsure how to interpret, but not fully blocked.',
+    '  - `"assumption"`: Proceeded with a guess; please verify the assumption.',
+    '  - `"informational"`: FYI only — agent proceeded fine and no reply is required.',
+    "- **suggestedKey** *(optional)*: A suggested answer key for reference."
   ].join(`
 `),
   _signals: [
     {
       key: FEEDBACK_REQUEST_SIGNAL_KEY,
-      sourcePath: "feedbackRequests",
+      sourcePath: FEEDBACK_REQUEST_RESULT_KEY,
       type: "array",
       required: false
     }

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

@@ -15,18 +15,19 @@ export type StepFeature<TResultExtension extends Record<string, unknown> = Recor
 };
 export type AnyStepFeature = StepFeature<Record<string, unknown>, string>;
 type UnionToIntersection<U> = (U extends unknown ? (x: U) => void : never) extends (x: infer I) => void ? I : never;
-export type FeatureResultExtensions<TFeatures extends readonly AnyStepFeature[]> = [
-    TFeatures[number]
-] extends [never] ? Record<never, never> : UnionToIntersection<TFeatures[number] extends StepFeature<infer R, string> ? R : never>;
+export type FeatureResultExtensions<TFeatures extends readonly AnyStepFeature[]> = [TFeatures[number]] extends [never] ? Record<never, never> : UnionToIntersection<TFeatures[number] extends StepFeature<infer R, string> ? R : never>;
 export type FeatureSignalKeys<TFeatures extends readonly AnyStepFeature[]> = TFeatures[number] extends StepFeature<Record<string, unknown>, infer K> ? K : never;
+export type FeedbackRequestUrgency = "blocking" | "clarification" | "assumption" | "informational";
 export type FeedbackRequestItem = {
     question: string;
     category: string;
+    urgency: FeedbackRequestUrgency;
     suggestedKey?: string;
 };
 declare const FEEDBACK_REQUEST_SIGNAL_KEY: "$boboddy_feedback_request_v1";
+declare const FEEDBACK_REQUEST_RESULT_KEY: "$boboddy_feedbackRequests_v1";
 type FeedbackRequestsFeature = StepFeature<{
-    feedbackRequests?: FeedbackRequestItem[];
+    [FEEDBACK_REQUEST_RESULT_KEY]?: FeedbackRequestItem[];
 }, typeof FEEDBACK_REQUEST_SIGNAL_KEY>;
 export declare const Features: {
     readonly feedbackRequests: (() => FeedbackRequestsFeature) & {

package/dist/index.js

@@ -15755,28 +15755,43 @@ function date4(params) {
 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(),
-  category: exports_external.string(),
-  suggestedKey: exports_external.string().optional()
-});
+  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 — unsure how to interpret, but not fully blocked.',
+    '- "assumption": proceeded with a guess; please verify the assumption.',
+    '- "informational": FYI only — 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 = {
   _resultExtension: exports_external.object({
-    feedbackRequests: exports_external.array(feedbackRequestItemSchema).optional()
+    [FEEDBACK_REQUEST_RESULT_KEY]: exports_external.array(feedbackRequestItemSchema).optional()
   }),
   _promptAddition: [
     "## Feedback Requests",
     "",
-    "If you encounter anything that warrants human review, populate the `feedbackRequests` array:",
-    "- **question**: The specific question to pose to a human reviewer",
-    '- **category**: A grouping label for the feedback (e.g. `"accuracy"`, `"completeness"`)',
-    "- **suggestedKey** *(optional)*: A suggested answer key for reference"
+    `If you encounter anything that warrants human review, populate the \`${FEEDBACK_REQUEST_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 — unsure how to interpret, but not fully blocked.',
+    '  - `"assumption"`: Proceeded with a guess; please verify the assumption.',
+    '  - `"informational"`: FYI only — agent proceeded fine and no reply is required.',
+    "- **suggestedKey** *(optional)*: A suggested answer key for reference."
   ].join(`
 `),
   _signals: [
     {
       key: FEEDBACK_REQUEST_SIGNAL_KEY,
-      sourcePath: "feedbackRequests",
+      sourcePath: FEEDBACK_REQUEST_RESULT_KEY,
       type: "array",
       required: false
     }
@@ -15846,7 +15861,13 @@ function resolveOutcome(outcome) {
   if (typeof outcome === "string") {
     return { type: outcome, params: null };
   }
-  return { type: outcome.outcome, params: outcome.outcomeJson ?? null };
+  return {
+    type: "route",
+    params: {
+      pipelineKey: outcome.pipelineKey,
+      ...outcome.inputJson != null ? { inputJson: outcome.inputJson } : {}
+    }
+  };
 }
 function serializeCondition(condition) {
   if (condition._tag === "signal") {

package/package.json

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