@boboddy/sdk 0.1.0-alpha → 0.1.2-alpha

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

@@ -0,0 +1,42 @@
+import type { ZodObject, ZodRawShape } from "zod";
+type FeatureSignalSpec = {
+    key: string;
+    sourcePath: string;
+    type: "string" | "number" | "boolean" | "object" | "array";
+    required?: boolean;
+    availableWhenResultStatusIn?: string[] | null;
+};
+export type StepFeature<TResultExtension extends Record<string, unknown> = Record<string, unknown>, TSignalKeys extends string = string> = {
+    readonly _resultExtension: ZodObject<ZodRawShape>;
+    readonly _promptAddition: string;
+    readonly _signals: FeatureSignalSpec[];
+    readonly __resultExtension?: TResultExtension;
+    readonly __signalKeys?: TSignalKeys;
+};
+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 FeatureSignalKeys<TFeatures extends readonly AnyStepFeature[]> = TFeatures[number] extends StepFeature<Record<string, unknown>, infer K> ? K : never;
+export type FeedbackRequestItem = {
+    question: string;
+    category: string;
+    suggestedKey?: string;
+};
+declare const FEEDBACK_REQUEST_SIGNAL_KEY: "$boboddy_feedback_request_v1";
+type FeedbackRequestsFeature = StepFeature<{
+    feedbackRequests?: FeedbackRequestItem[];
+}, typeof FEEDBACK_REQUEST_SIGNAL_KEY>;
+export declare const Features: {
+    readonly feedbackRequests: (() => FeedbackRequestsFeature) & {
+        signal: {
+            key: "$boboddy_feedback_request_v1";
+            find(signals: Array<{
+                key: string;
+                valueJson: unknown;
+            }>): FeedbackRequestItem[] | undefined;
+        };
+    };
+};
+export {};

package/dist/index.js

@@ -13301,6 +13301,20 @@ function deriveSignalType(schema, path) {
   }
 }
 function defineStep(config2) {
+  const features = config2.features ?? [];
+  let effectiveResult = config2.result;
+  for (const feature of features) {
+    effectiveResult = effectiveResult ? effectiveResult.extend(feature._resultExtension.shape) : feature._resultExtension;
+  }
+  let effectivePrompt = config2.prompt ?? null;
+  for (const feature of features) {
+    if (feature._promptAddition) {
+      effectivePrompt = effectivePrompt ? `${effectivePrompt}
+
+${feature._promptAddition}` : feature._promptAddition;
+    }
+  }
+  const featureSignals = features.flatMap((f) => f._signals);
   const spec = {
     key: config2.key,
     name: config2.name,
@@ -13308,16 +13322,25 @@ function defineStep(config2) {
     version: config2.version ?? 1,
     kind: "user_defined",
     status: config2.status ?? "active",
-    prompt: config2.prompt ?? null,
+    prompt: effectivePrompt,
     inputSchemaJson: config2.input ? toJSONSchema(config2.input) : null,
-    resultSchemaJson: config2.result ? toJSONSchema(config2.result) : null,
-    signalExtractorDefinitions: (config2.signals ?? []).map((s) => ({
-      key: s.key ?? s.sourcePath,
-      sourcePath: s.sourcePath,
-      type: s.type ?? deriveSignalType(config2.result, s.sourcePath),
-      required: s.required ?? true,
-      availableWhenResultStatusIn: s.availableWhenResultStatusIn ?? null
-    })),
+    resultSchemaJson: effectiveResult ? toJSONSchema(effectiveResult) : null,
+    signalExtractorDefinitions: [
+      ...(config2.signals ?? []).map((s) => ({
+        key: s.key ?? s.sourcePath,
+        sourcePath: s.sourcePath,
+        type: s.type ?? deriveSignalType(config2.result, s.sourcePath),
+        required: s.required ?? true,
+        availableWhenResultStatusIn: s.availableWhenResultStatusIn ?? null
+      })),
+      ...featureSignals.map((s) => ({
+        key: s.key,
+        sourcePath: s.sourcePath,
+        type: s.type,
+        required: s.required ?? true,
+        availableWhenResultStatusIn: s.availableWhenResultStatusIn ?? null
+      }))
+    ],
     computedSignalDefinitions: (config2.computedSignals ?? []).map((cs) => ({
       key: cs.key,
       type: cs.type,
@@ -13366,125 +13389,6 @@ var buildStepDefinitionsClient = (stepDefinitions) => {
     }
   };
 };
-// src/definitions/advancement-policies/define-advancement-policy.ts
-function signal(signal2, operator, value) {
-  return { _tag: "signal", signal: signal2, operator, value };
-}
-function all(conditions, outcome) {
-  if (outcome === undefined) {
-    return { _tag: "all", conditions };
-  }
-  return { _tag: "rule", mode: "all", conditions, outcome };
-}
-function any(conditions, outcome) {
-  if (outcome === undefined) {
-    return { _tag: "any", conditions };
-  }
-  return { _tag: "rule", mode: "any", conditions, outcome };
-}
-function when(signal2, operator, value, outcome) {
-  return {
-    _tag: "rule",
-    mode: "all",
-    conditions: [{ _tag: "signal", signal: signal2, operator, value }],
-    outcome
-  };
-}
-var Rule = { signal, all, any, when };
-function resolveOutcome(outcome) {
-  if (typeof outcome === "string") {
-    return { type: outcome, params: null };
-  }
-  return { type: outcome.outcome, params: outcome.outcomeJson ?? null };
-}
-function serializeCondition(condition) {
-  if (condition._tag === "signal") {
-    return {
-      fact: condition.signal,
-      operator: condition.operator,
-      value: condition.value
-    };
-  }
-  if (condition._tag === "all") {
-    return { all: condition.conditions.map(serializeCondition) };
-  }
-  return { any: condition.conditions.map(serializeCondition) };
-}
-function serializeRule(rule) {
-  const resolved = resolveOutcome(rule.outcome);
-  return {
-    conditions: { [rule.mode]: rule.conditions.map(serializeCondition) },
-    event: {
-      type: resolved.type,
-      ...resolved.params ? { params: resolved.params } : {}
-    }
-  };
-}
-function serializeAdvancementPolicy(policy) {
-  if (!policy) {
-    return {
-      rulesJson: { rules: [] },
-      defaultEventType: "continue",
-      defaultEventParamsJson: null,
-      allowedEventTypes: ["continue"]
-    };
-  }
-  const defaultResolved = resolveOutcome(policy.defaultOutcome);
-  const outcomeSet = new Set([defaultResolved.type]);
-  const serializedRules = (policy.rules ?? []).map((rule) => {
-    outcomeSet.add(resolveOutcome(rule.outcome).type);
-    return serializeRule(rule);
-  });
-  return {
-    rulesJson: { rules: serializedRules },
-    defaultEventType: defaultResolved.type,
-    defaultEventParamsJson: defaultResolved.params,
-    allowedEventTypes: [...outcomeSet]
-  };
-}
-
-// src/definitions/pipelines/define-pipeline.ts
-function fromPipelineInput(_schema, path) {
-  return { source: "pipeline_input", path };
-}
-function fromSignal(step, signalKey) {
-  return { source: "step_signal", step, signalKey };
-}
-function stepOutput(step) {
-  return { source: "step_output", step };
-}
-function serializeBinding(binding) {
-  if (binding.source === "pipeline_input") {
-    return { source: "pipeline_input", path: binding.path };
-  }
-  if (binding.source === "step_signal") {
-    return {
-      source: "step_signal",
-      stepKey: binding.step.key,
-      signalKey: binding.signalKey
-    };
-  }
-  return { source: "step_output", stepKey: binding.step.key };
-}
-function definePipeline(config2) {
-  const steps = config2.steps;
-  return {
-    key: config2.key,
-    name: config2.name,
-    description: config2.description ?? null,
-    version: config2.version ?? 1,
-    status: config2.status ?? "active",
-    steps: steps.map((stepConfig, index) => ({
-      stepKey: stepConfig.step.key,
-      stepName: stepConfig.step.name,
-      stepDescription: stepConfig.step.description,
-      position: index + 1,
-      inputBindingsJson: Object.fromEntries(Object.entries(stepConfig.input ?? {}).filter((entry) => entry[1] !== undefined).map(([key, binding]) => [key, serializeBinding(binding)])),
-      timeoutSeconds: stepConfig.timeout ?? null,
-      advancementPolicyDefinition: serializeAdvancementPolicy(stepConfig.advancement)
-    }))
-  };
-}
 // ../../../node_modules/.bun/zod@4.4.3/node_modules/zod/v4/classic/external.js
 var exports_external = {};
 __export(exports_external, {
@@ -13640,7 +13544,7 @@ __export(exports_external, {
   base64url: () => base64url2,
   base64: () => base642,
   array: () => array,
-  any: () => any2,
+  any: () => any,
   _function: () => _function,
   _default: () => _default2,
   _ZodString: () => _ZodString,
@@ -13824,7 +13728,7 @@ __export(exports_schemas2, {
   base64url: () => base64url2,
   base64: () => base642,
   array: () => array,
-  any: () => any2,
+  any: () => any,
   _function: () => _function,
   _default: () => _default2,
   _ZodString: () => _ZodString,
@@ -14613,7 +14517,7 @@ var ZodAny = /* @__PURE__ */ $constructor("ZodAny", (inst, def) => {
   ZodType.init(inst, def);
   inst._zod.processJSONSchema = (ctx, json, params) => anyProcessor(inst, ctx, json, params);
 });
-function any2() {
+function any() {
   return _any(ZodAny);
 }
 var ZodUnknown = /* @__PURE__ */ $constructor("ZodUnknown", (inst, def) => {
@@ -15828,6 +15732,209 @@ 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 feedbackRequestItemSchema = exports_external.object({
+  question: exports_external.string(),
+  category: exports_external.string(),
+  suggestedKey: exports_external.string().optional()
+});
+var feedbackRequestsFeature = {
+  _resultExtension: exports_external.object({
+    feedbackRequests: 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"
+  ].join(`
+`),
+  _signals: [
+    {
+      key: FEEDBACK_REQUEST_SIGNAL_KEY,
+      sourcePath: "feedbackRequests",
+      type: "array",
+      required: false
+    }
+  ]
+};
+var Features = {
+  feedbackRequests: Object.assign(() => feedbackRequestsFeature, {
+    signal: {
+      key: FEEDBACK_REQUEST_SIGNAL_KEY,
+      find(signals) {
+        const match = signals.find((s) => s.key === FEEDBACK_REQUEST_SIGNAL_KEY);
+        if (!match)
+          return;
+        const parsed = exports_external.array(feedbackRequestItemSchema).safeParse(match.valueJson);
+        return parsed.success ? parsed.data : undefined;
+      }
+    }
+  })
+};
+// src/definitions/advancement-policies/define-advancement-policy.ts
+function signal(signal2, operator, value) {
+  return { _tag: "signal", signal: signal2, operator, value };
+}
+function all(conditions, outcome) {
+  if (outcome === undefined) {
+    return { _tag: "all", conditions };
+  }
+  return { _tag: "rule", mode: "all", conditions, outcome };
+}
+function any2(conditions, outcome) {
+  if (outcome === undefined) {
+    return { _tag: "any", conditions };
+  }
+  return { _tag: "rule", mode: "any", conditions, outcome };
+}
+function when(signal2, operator, value, outcome) {
+  return {
+    _tag: "rule",
+    mode: "all",
+    conditions: [{ _tag: "signal", signal: signal2, operator, value }],
+    outcome
+  };
+}
+var Rule = { signal, all, any: any2, when };
+function resolveOutcome(outcome) {
+  if (typeof outcome === "string") {
+    return { type: outcome, params: null };
+  }
+  return { type: outcome.outcome, params: outcome.outcomeJson ?? null };
+}
+function serializeCondition(condition) {
+  if (condition._tag === "signal") {
+    return {
+      fact: condition.signal,
+      operator: condition.operator,
+      value: condition.value
+    };
+  }
+  if (condition._tag === "all") {
+    return { all: condition.conditions.map(serializeCondition) };
+  }
+  return { any: condition.conditions.map(serializeCondition) };
+}
+function serializeRule(rule) {
+  const resolved = resolveOutcome(rule.outcome);
+  return {
+    conditions: { [rule.mode]: rule.conditions.map(serializeCondition) },
+    event: {
+      type: resolved.type,
+      ...resolved.params ? { params: resolved.params } : {}
+    }
+  };
+}
+function serializeAdvancementPolicy(policy) {
+  if (!policy) {
+    return {
+      rulesJson: { rules: [] },
+      defaultEventType: "continue",
+      defaultEventParamsJson: null,
+      allowedEventTypes: ["continue"]
+    };
+  }
+  const defaultResolved = resolveOutcome(policy.defaultOutcome);
+  const outcomeSet = new Set([defaultResolved.type]);
+  const serializedRules = (policy.rules ?? []).map((rule) => {
+    outcomeSet.add(resolveOutcome(rule.outcome).type);
+    return serializeRule(rule);
+  });
+  return {
+    rulesJson: { rules: serializedRules },
+    defaultEventType: defaultResolved.type,
+    defaultEventParamsJson: defaultResolved.params,
+    allowedEventTypes: [...outcomeSet]
+  };
+}
+
+// src/definitions/pipelines/define-pipeline.ts
+function fromPipelineInput(_schema, path) {
+  return { source: "pipeline_input", path };
+}
+function fromSignal(step, signalKey) {
+  return { source: "step_signal", step, signalKey };
+}
+function stepOutput(step) {
+  return { source: "step_output", step };
+}
+function serializeBinding(binding) {
+  if (binding.source === "pipeline_input") {
+    return { source: "pipeline_input", path: binding.path };
+  }
+  if (binding.source === "step_signal") {
+    return {
+      source: "step_signal",
+      stepKey: binding.step.key,
+      signalKey: binding.signalKey
+    };
+  }
+  return { source: "step_output", stepKey: binding.step.key };
+}
+function definePipeline(config2) {
+  const steps = config2.steps;
+  return {
+    key: config2.key,
+    name: config2.name,
+    description: config2.description ?? null,
+    version: config2.version ?? 1,
+    status: config2.status ?? "active",
+    steps: steps.map((stepConfig, index) => ({
+      stepKey: stepConfig.step.key,
+      stepName: stepConfig.step.name,
+      stepDescription: stepConfig.step.description,
+      position: index + 1,
+      inputBindingsJson: Object.fromEntries(Object.entries(stepConfig.input ?? {}).filter((entry) => entry[1] !== undefined).map(([key, binding]) => [key, serializeBinding(binding)])),
+      timeoutSeconds: stepConfig.timeout ?? null,
+      advancementPolicyDefinition: serializeAdvancementPolicy(stepConfig.advancement)
+    }))
+  };
+}
+// src/definitions/pipelines/pipeline-definitions-client.ts
+function createPipelineDefinitionsClient(baseUrl) {
+  const base = baseUrl.replace(/\/$/, "");
+  async function doFetch(path, method, headers, body) {
+    const requestHeaders = { ...headers };
+    if (body !== undefined) {
+      requestHeaders["Content-Type"] = "application/json";
+    }
+    const response = await fetch(`${base}${path}`, {
+      method,
+      headers: requestHeaders,
+      ...body !== undefined ? { body: JSON.stringify(body) } : {}
+    });
+    if (!response.ok) {
+      const err = await response.json().catch(() => null);
+      throw new Error(err?.title ?? `HTTP ${String(response.status)} ${method} ${path}`);
+    }
+    return response.json().catch(() => null);
+  }
+  return buildPipelineDefinitionsClient(base, doFetch);
+}
+var buildPipelineDefinitionsClient = (_base, doFetch) => ({
+  listByProjectId: async (projectId, options) => {
+    const path = `/api/linear-pipeline-definitions?projectId=${encodeURIComponent(projectId)}`;
+    const result = await doFetch(path, "GET", options?.headers ?? {});
+    return result ?? [];
+  },
+  create: async (body, options) => {
+    const result = await doFetch("/api/linear-pipeline-definitions", "POST", options?.headers ?? {}, body);
+    return result;
+  },
+  update: async (pipelineId, body, options) => {
+    await doFetch(`/api/linear-pipeline-definitions/${pipelineId}`, "PUT", options?.headers ?? {}, body);
+  },
+  addStep: async (pipelineId, body, options) => {
+    await doFetch(`/api/linear-pipeline-definitions/${pipelineId}/steps`, "POST", options?.headers ?? {}, body);
+  },
+  removeStep: async (pipelineId, stepId, options) => {
+    await doFetch(`/api/linear-pipeline-definitions/${pipelineId}/steps/${stepId}`, "DELETE", options?.headers ?? {});
+  }
+});
 // src/opencode-mcp.ts
 var nonEmptyStringSchema = exports_external.string().trim().min(1);
 var mcpStringMapSchema = exports_external.record(exports_external.string(), exports_external.string());
@@ -16485,6 +16592,7 @@ export {
   definePipeline,
   createStepExecutionPlaneClient,
   createStepDefinitionsClient,
+  createPipelineDefinitionsClient,
   createBoboddyClient,
   WorkItems,
   StepExecutions,
@@ -16496,6 +16604,7 @@ export {
   PipelineExecutions,
   PipelineDefinitions,
   FeedbackRequests,
+  Features,
   BoboddyClient,
   BOBODDY_CONFIG_RELATIVE_PATH,
   Api

package/package.json

@@ -1,53 +1,53 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@boboddy/sdk",
-  "version": "0.1.0-alpha",
+  "version": "0.1.2-alpha",
   "type": "module",
   "exports": {
     ".": {
-      "types": "./src/index.ts",
+      "types": "./dist/index.d.ts",
       "bun": "./src/index.ts",
       "import": "./src/index.ts",
       "default": "./src/index.ts"
     },
     "./client": {
-      "types": "./src/client.ts",
+      "types": "./dist/client.d.ts",
       "bun": "./src/client.ts",
       "import": "./src/client.ts",
       "default": "./src/client.ts"
     },
     "./definitions/steps": {
-      "types": "./src/definitions/steps/index.ts",
+      "types": "./dist/definitions/steps/index.d.ts",
       "bun": "./src/definitions/steps/index.ts",
       "import": "./src/definitions/steps/index.ts",
       "default": "./src/definitions/steps/index.ts"
     },
     "./definitions/pipelines": {
-      "types": "./src/definitions/pipelines/index.ts",
+      "types": "./dist/definitions/pipelines/index.d.ts",
       "bun": "./src/definitions/pipelines/index.ts",
       "import": "./src/definitions/pipelines/index.ts",
       "default": "./src/definitions/pipelines/index.ts"
     },
     "./definitions/advancement-policies": {
-      "types": "./src/definitions/advancement-policies/index.ts",
+      "types": "./dist/definitions/advancement-policies/index.d.ts",
       "bun": "./src/definitions/advancement-policies/index.ts",
       "import": "./src/definitions/advancement-policies/index.ts",
       "default": "./src/definitions/advancement-policies/index.ts"
     },
     "./opencode-mcp": {
-      "types": "./src/opencode-mcp.ts",
+      "types": "./dist/opencode-mcp.d.ts",
       "bun": "./src/opencode-mcp.ts",
       "import": "./src/opencode-mcp.ts",
       "default": "./src/opencode-mcp.ts"
     },
     "./jsonc": {
-      "types": "./src/jsonc.ts",
+      "types": "./dist/jsonc.d.ts",
       "bun": "./src/jsonc.ts",
       "import": "./src/jsonc.ts",
       "default": "./src/jsonc.ts"
     },
     "./boboddy-config-parser": {
-      "types": "./src/boboddy-config-parser.ts",
+      "types": "./dist/boboddy-config-parser.d.ts",
       "bun": "./src/boboddy-config-parser.ts",
       "import": "./src/boboddy-config-parser.ts",
       "default": "./src/boboddy-config-parser.ts"
@@ -57,8 +57,54 @@
     "dist",
     "README.md"
   ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/connorivy/boboddy"
+  },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "import": "./dist/index.js",
+        "default": "./dist/index.js"
+      },
+      "./client": {
+        "types": "./dist/client.d.ts",
+        "import": "./dist/client.js",
+        "default": "./dist/client.js"
+      },
+      "./definitions/steps": {
+        "types": "./dist/definitions/steps/index.d.ts",
+        "import": "./dist/definitions/steps/index.js",
+        "default": "./dist/definitions/steps/index.js"
+      },
+      "./definitions/pipelines": {
+        "types": "./dist/definitions/pipelines/index.d.ts",
+        "import": "./dist/definitions/pipelines/index.js",
+        "default": "./dist/definitions/pipelines/index.js"
+      },
+      "./definitions/advancement-policies": {
+        "types": "./dist/definitions/advancement-policies/index.d.ts",
+        "import": "./dist/definitions/advancement-policies/index.js",
+        "default": "./dist/definitions/advancement-policies/index.js"
+      },
+      "./opencode-mcp": {
+        "types": "./dist/opencode-mcp.d.ts",
+        "import": "./dist/opencode-mcp.js",
+        "default": "./dist/opencode-mcp.js"
+      },
+      "./jsonc": {
+        "types": "./dist/jsonc.d.ts",
+        "import": "./dist/jsonc.js",
+        "default": "./dist/jsonc.js"
+      },
+      "./boboddy-config-parser": {
+        "types": "./dist/boboddy-config-parser.d.ts",
+        "import": "./dist/boboddy-config-parser.js",
+        "default": "./dist/boboddy-config-parser.js"
+      }
+    }
   },
   "scripts": {
     "generate": "openapi-ts",