@boboddy/sdk 0.1.15-alpha → 0.1.16-alpha

package/dist/definitions/pipelines/builder.d.ts

@@ -1,7 +1,7 @@
 import { z, type ZodType } from "zod";
 import type { TypedStepDefinitionSpec } from "../steps/define-step";
 import { type AdvanceCtx, type AdvanceResult } from "../advancement-policies/fluent-rules";
-import { type AnyBinding, type PipelineDefinitionSpec, type PipelineStepConfig, type StepOutputBinding, type StepSignalBinding, type WorkItemBinding } from "./define-pipeline";
+import { type AnyBinding, type LiteralBinding, type PipelineDefinitionSpec, type PipelineStepConfig, type StepOutputBinding, type StepSignalBinding, type WorkItemBinding } from "./define-pipeline";
 import { type InputAccessor } from "./input-accessor";
 type AnyTypedStep = TypedStepDefinitionSpec<any, any, any, any>;
 export type StepConfig = {
@@ -15,6 +15,9 @@ type LastStep<T extends ReadonlyArray<AnyTypedStep>> = T extends readonly [
 type LastSignalKeys<T extends ReadonlyArray<AnyTypedStep>> = LastStep<T> extends AnyTypedStep ? LastStep<T>["__signalKeys"] : never;
 type LastSignalTypeMap<T extends ReadonlyArray<AnyTypedStep>> = LastStep<T> extends AnyTypedStep ? LastStep<T>["__signalTypeMap"] : Record<string, unknown>;
 type IsAny<T> = 0 extends 1 & T ? true : false;
+type Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
 type RequiredInputKeys<T extends object> = {
     [K in keyof T & string]-?: undefined extends T[K] ? never : K;
 }[keyof T & string];
@@ -29,20 +32,39 @@ type StepInputMapping<S extends AnyTypedStep> = IsAny<S["__inputType"]> extends
 export type WorkItemAccessor = {
     readonly title: WorkItemBinding;
     readonly description: WorkItemBinding;
+    readonly field: (fieldName: string) => WorkItemBinding;
 };
+type WithWorkItemFields<T> = {
+    workItemTitle: string;
+    workItemDescription: string | null;
+} & T;
 export type StepInputCtx<TInput extends ZodType, TSteps extends ReadonlyArray<AnyTypedStep>> = {
-    input: InputAccessor<TInput["_output"]>;
-    workItem: WorkItemAccessor;
+    input: InputAccessor<Prettify<WithWorkItemFields<TInput["_output"]>>>;
     signal: <S extends ElementOf<TSteps>>(step: S, key: S["__signalKeys"]) => StepSignalBinding;
     output: <S extends ElementOf<TSteps>>(step: S) => StepOutputBinding;
+    literal: (value: unknown) => LiteralBinding;
 };
+type ReservedPipelineInputKeys = "workItemTitle" | "workItemDescription";
+type NoReservedKeys<T extends ZodType> = T extends {
+    shape: infer Shape;
+} ? [string & keyof Shape & ReservedPipelineInputKeys] extends [never] ? T : never : T;
 export type PipelineMeta<TInput extends ZodType = z.ZodUnknown> = {
     key: string;
     name: string;
     description?: string;
     version?: number;
     status?: "draft" | "active";
-    input?: TInput;
+    additionalPipelineInput?: {
+        schema: NoReservedKeys<TInput>;
+        bindings: (ctx: {
+            workItem: WorkItemAccessor;
+            literal: (value: unknown) => LiteralBinding;
+        }) => TInput["_output"] extends object ? {
+            [K in RequiredInputKeys<TInput["_output"]>]: AnyBinding;
+        } & {
+            [K in OptionalInputKeys<TInput["_output"]>]?: AnyBinding;
+        } : Partial<Record<string, AnyBinding>>;
+    };
 };
 /**
  * Returned by `.step()`. Requires `.advance()` before the pipeline can
@@ -50,10 +72,11 @@ export type PipelineMeta<TInput extends ZodType = z.ZodUnknown> = {
  */
 export declare class PipelineStepAdvancementBuilder<TInput extends ZodType, TSteps extends ReadonlyArray<AnyTypedStep>> {
     protected readonly inputSchema: TInput;
-    protected readonly meta: Omit<PipelineMeta<TInput>, "input">;
+    protected readonly meta: Omit<PipelineMeta<TInput>, "additionalPipelineInput">;
     protected readonly steps: PipelineStepConfig[];
+    protected readonly pipelineInputBindings: Record<string, AnyBinding>;
     readonly __steps: TSteps;
-    constructor(inputSchema: TInput, meta: Omit<PipelineMeta<TInput>, "input">, steps: PipelineStepConfig[]);
+    constructor(inputSchema: TInput, meta: Omit<PipelineMeta<TInput>, "additionalPipelineInput">, steps: PipelineStepConfig[], pipelineInputBindings?: Record<string, AnyBinding>);
     advance(callback: (ctx: AdvanceCtx<LastSignalKeys<TSteps>, LastSignalTypeMap<TSteps>>) => AdvanceResult<LastSignalKeys<TSteps>>): PipelineStepBuilder<TInput, TSteps>;
 }
 /**
@@ -62,10 +85,11 @@ export declare class PipelineStepAdvancementBuilder<TInput extends ZodType, TSte
  */
 export declare class PipelineStepBuilder<TInput extends ZodType, TSteps extends ReadonlyArray<AnyTypedStep>> {
     protected readonly inputSchema: TInput;
-    protected readonly meta: Omit<PipelineMeta<TInput>, "input">;
+    protected readonly meta: Omit<PipelineMeta<TInput>, "additionalPipelineInput">;
     protected readonly steps: PipelineStepConfig[];
+    protected readonly pipelineInputBindings: Record<string, AnyBinding>;
     readonly __steps: TSteps;
-    constructor(inputSchema: TInput, meta: Omit<PipelineMeta<TInput>, "input">, steps: PipelineStepConfig[]);
+    constructor(inputSchema: TInput, meta: Omit<PipelineMeta<TInput>, "additionalPipelineInput">, steps: PipelineStepConfig[], pipelineInputBindings?: Record<string, AnyBinding>);
     step<S extends AnyTypedStep>(step: S, mapper: (ctx: StepInputCtx<TInput, TSteps>) => StepInputMapping<S>, configFn?: (config: StepConfig) => void): PipelineStepAdvancementBuilder<TInput, [...TSteps, S]>;
     build(): PipelineDefinitionSpec;
 }
@@ -78,8 +102,10 @@ export declare class PipelineBuilder<TInput extends ZodType> {
     private readonly inputSchema;
     private readonly meta;
     private readonly steps;
+    private readonly pipelineInputBindings;
     constructor(meta: PipelineMeta<TInput>);
     step<S extends AnyTypedStep>(step: S, mapper: (ctx: StepInputCtx<TInput, []>) => StepInputMapping<S>, configFn?: (config: StepConfig) => void): PipelineStepAdvancementBuilder<TInput, [S]>;
 }
+export declare function literal(value: unknown): LiteralBinding;
 export declare function pipeline<TInput extends ZodType = z.ZodUnknown>(meta: PipelineMeta<TInput>): PipelineBuilder<TInput>;
 export {};

package/dist/definitions/pipelines/define-pipeline.d.ts

@@ -10,7 +10,7 @@ export type PipelineInputBinding = {
 };
 export type WorkItemBinding = {
     source: "work_item";
-    field: "title" | "description";
+    field: string;
 };
 export type StepSignalBinding = {
     source: "step_signal";
@@ -21,7 +21,11 @@ export type StepOutputBinding = {
     source: "step_output";
     step: AnyTypedStep;
 };
-export type AnyBinding = PipelineInputBinding | WorkItemBinding | StepSignalBinding | StepOutputBinding;
+export type LiteralBinding = {
+    source: "literal";
+    value: unknown;
+};
+export type AnyBinding = PipelineInputBinding | WorkItemBinding | StepSignalBinding | StepOutputBinding | LiteralBinding;
 export type PipelineStepConfig<TStep extends AnyTypedStep = AnyTypedStep> = {
     step: TStep;
     /** Maps each step input field to an input source. Extra keys are ignored at runtime. */
@@ -44,7 +48,7 @@ type SerializedBinding = {
     path: string;
 } | {
     source: "work_item";
-    field: "title" | "description";
+    field: string;
 } | {
     source: "step_signal";
     stepKey: string;
@@ -52,6 +56,9 @@ type SerializedBinding = {
 } | {
     source: "step_output";
     stepKey: string;
+} | {
+    source: "literal";
+    value: unknown;
 };
 export type PipelineDefinitionSpec = {
     key: string;
@@ -81,5 +88,6 @@ export type DefinePipelineInput = {
     status?: "draft" | "active";
     input?: ZodType | null;
     steps: ReadonlyArray<PipelineStepConfig>;
+    pipelineInputBindings?: Record<string, AnyBinding>;
 };
 export declare function buildPipelineSpec(config: DefinePipelineInput): PipelineDefinitionSpec;

package/dist/definitions/pipelines/index.js

@@ -14449,6 +14449,9 @@ function serializeBinding(binding) {
       signalKey: binding.signalKey
     };
   }
+  if (binding.source === "literal") {
+    return { source: "literal", value: binding.value };
+  }
   return { source: "step_output", stepKey: binding.step.key };
 }
 function buildPipelineSpec(config2) {
@@ -14476,16 +14479,31 @@ function buildPipelineSpec(config2) {
     status: config2.status ?? "active",
     inputSchemaJson,
     _stepDefinitions: [...stepDefMap.values()],
-    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),
-      computedSignalDefinitions: extractInlineComputedSignals(stepConfig.advancement)
-    }))
+    steps: steps.map((stepConfig, index) => {
+      const autoBindings = {
+        workItemTitle: { source: "work_item", field: "title" },
+        workItemDescription: { source: "work_item", field: "description" }
+      };
+      const pipelineBindings = {};
+      for (const [key, binding] of Object.entries(config2.pipelineInputBindings ?? {})) {
+        pipelineBindings[key] = serializeBinding(binding);
+      }
+      const explicitStepBindings = Object.fromEntries(Object.entries(stepConfig.input ?? {}).filter((entry) => entry[1] !== undefined).map(([key, binding]) => [key, serializeBinding(binding)]));
+      return {
+        stepKey: stepConfig.step.key,
+        stepName: stepConfig.step.name,
+        stepDescription: stepConfig.step.description,
+        position: index + 1,
+        inputBindingsJson: {
+          ...autoBindings,
+          ...pipelineBindings,
+          ...explicitStepBindings
+        },
+        timeoutSeconds: stepConfig.timeout ?? null,
+        advancementPolicyDefinition: serializeAdvancementPolicy(stepConfig.advancement),
+        computedSignalDefinitions: extractInlineComputedSignals(stepConfig.advancement)
+      };
+    })
   };
 }
 // src/definitions/advancement-policies/fluent-rules.ts
@@ -14630,10 +14648,12 @@ class PipelineStepAdvancementBuilder {
   inputSchema;
   meta;
   steps;
-  constructor(inputSchema, meta3, steps) {
+  pipelineInputBindings;
+  constructor(inputSchema, meta3, steps, pipelineInputBindings = {}) {
     this.inputSchema = inputSchema;
     this.meta = meta3;
     this.steps = steps;
+    this.pipelineInputBindings = pipelineInputBindings;
   }
   advance(callback) {
     const last = this.steps.at(-1);
@@ -14644,7 +14664,7 @@ class PipelineStepAdvancementBuilder {
       ...result.rules !== undefined ? { rules: result.rules } : {}
     };
     last.advancement = policy;
-    return new PipelineStepBuilder(this.inputSchema, this.meta, this.steps);
+    return new PipelineStepBuilder(this.inputSchema, this.meta, this.steps, this.pipelineInputBindings);
   }
 }
 
@@ -14652,10 +14672,12 @@ class PipelineStepBuilder {
   inputSchema;
   meta;
   steps;
-  constructor(inputSchema, meta3, steps) {
+  pipelineInputBindings;
+  constructor(inputSchema, meta3, steps, pipelineInputBindings = {}) {
     this.inputSchema = inputSchema;
     this.meta = meta3;
     this.steps = steps;
+    this.pipelineInputBindings = pipelineInputBindings;
   }
   step(step, mapper, configFn) {
     const ctx = makeStepInputCtx(this.inputSchema);
@@ -14669,7 +14691,7 @@ class PipelineStepBuilder {
         stepConfig.timeout = cfg.timeout;
     }
     this.steps.push(stepConfig);
-    return new PipelineStepAdvancementBuilder(this.inputSchema, this.meta, this.steps);
+    return new PipelineStepAdvancementBuilder(this.inputSchema, this.meta, this.steps, this.pipelineInputBindings);
   }
   build() {
     const config2 = {
@@ -14679,7 +14701,8 @@ class PipelineStepBuilder {
       version: this.meta.version,
       status: this.meta.status,
       input: this.inputSchema,
-      steps: this.steps
+      steps: this.steps,
+      pipelineInputBindings: this.pipelineInputBindings
     };
     return buildPipelineSpec(config2);
   }
@@ -14689,10 +14712,27 @@ class PipelineBuilder {
   inputSchema;
   meta;
   steps = [];
+  pipelineInputBindings;
   constructor(meta3) {
-    const { input, ...rest } = meta3;
-    this.inputSchema = input ?? exports_external.unknown();
+    const { additionalPipelineInput, ...rest } = meta3;
+    this.inputSchema = additionalPipelineInput?.schema ?? exports_external.unknown();
     this.meta = rest;
+    if (additionalPipelineInput) {
+      const raw = additionalPipelineInput.bindings({
+        workItem: WORK_ITEM_ACCESSOR,
+        literal: literal2
+      });
+      if (additionalPipelineInput.schema instanceof exports_external.ZodObject) {
+        const validKeys = new Set(Object.keys(additionalPipelineInput.schema.shape));
+        const unknown2 = Object.keys(raw).filter((k) => !validKeys.has(k));
+        if (unknown2.length > 0) {
+          throw new Error(`additionalPipelineInput.bindings returned key${unknown2.length > 1 ? "s" : ""} not in schema: ${unknown2.map((k) => `"${k}"`).join(", ")}`);
+        }
+      }
+      this.pipelineInputBindings = normalizeInputMapping(raw) ?? {};
+    } else {
+      this.pipelineInputBindings = {};
+    }
   }
   step(step, mapper, configFn) {
     const ctx = makeStepInputCtx(this.inputSchema);
@@ -14706,7 +14746,7 @@ class PipelineBuilder {
         stepConfig.timeout = cfg.timeout;
     }
     this.steps.push(stepConfig);
-    return new PipelineStepAdvancementBuilder(this.inputSchema, this.meta, this.steps);
+    return new PipelineStepAdvancementBuilder(this.inputSchema, this.meta, this.steps, this.pipelineInputBindings);
   }
 }
 var WORK_ITEM_ACCESSOR = Object.freeze({
@@ -14714,20 +14754,37 @@ var WORK_ITEM_ACCESSOR = Object.freeze({
   description: Object.freeze({
     source: "work_item",
     field: "description"
-  })
+  }),
+  field: (fieldName) => Object.freeze({ source: "work_item", field: `fields.${fieldName}` })
 });
+var WORK_ITEM_FIELD_BINDINGS = {
+  workItemTitle: { source: "work_item", field: "title" },
+  workItemDescription: { source: "work_item", field: "description" }
+};
 function makeStepInputCtx(inputSchema) {
+  const baseAccessor = createInputAccessor(inputSchema);
+  const input = new Proxy(baseAccessor, {
+    get(target, prop) {
+      if (typeof prop === "string" && prop in WORK_ITEM_FIELD_BINDINGS) {
+        return WORK_ITEM_FIELD_BINDINGS[prop];
+      }
+      return target[prop];
+    }
+  });
   return {
-    input: createInputAccessor(inputSchema),
-    workItem: WORK_ITEM_ACCESSOR,
+    input,
     signal(step, key) {
       return { source: "step_signal", step, signalKey: key };
     },
     output(step) {
       return { source: "step_output", step };
-    }
+    },
+    literal: literal2
   };
 }
+function literal2(value) {
+  return { source: "literal", value };
+}
 function normalizeInputMapping(mapping) {
   if (!mapping)
     return;
@@ -16115,6 +16172,7 @@ var buildPipelineDefinitionsClient = (pipelineDefinitions) => {
 export {
   pipeline,
   materializeAccessor,
+  literal2 as literal,
   isInputAccessor,
   createPipelineDefinitionsClient,
   createInputAccessor,

package/dist/index.js

@@ -16033,6 +16033,9 @@ function serializeBinding(binding) {
       signalKey: binding.signalKey
     };
   }
+  if (binding.source === "literal") {
+    return { source: "literal", value: binding.value };
+  }
   return { source: "step_output", stepKey: binding.step.key };
 }
 function buildPipelineSpec(config2) {
@@ -16060,16 +16063,31 @@ function buildPipelineSpec(config2) {
     status: config2.status ?? "active",
     inputSchemaJson,
     _stepDefinitions: [...stepDefMap.values()],
-    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),
-      computedSignalDefinitions: extractInlineComputedSignals(stepConfig.advancement)
-    }))
+    steps: steps.map((stepConfig, index) => {
+      const autoBindings = {
+        workItemTitle: { source: "work_item", field: "title" },
+        workItemDescription: { source: "work_item", field: "description" }
+      };
+      const pipelineBindings = {};
+      for (const [key, binding] of Object.entries(config2.pipelineInputBindings ?? {})) {
+        pipelineBindings[key] = serializeBinding(binding);
+      }
+      const explicitStepBindings = Object.fromEntries(Object.entries(stepConfig.input ?? {}).filter((entry) => entry[1] !== undefined).map(([key, binding]) => [key, serializeBinding(binding)]));
+      return {
+        stepKey: stepConfig.step.key,
+        stepName: stepConfig.step.name,
+        stepDescription: stepConfig.step.description,
+        position: index + 1,
+        inputBindingsJson: {
+          ...autoBindings,
+          ...pipelineBindings,
+          ...explicitStepBindings
+        },
+        timeoutSeconds: stepConfig.timeout ?? null,
+        advancementPolicyDefinition: serializeAdvancementPolicy(stepConfig.advancement),
+        computedSignalDefinitions: extractInlineComputedSignals(stepConfig.advancement)
+      };
+    })
   };
 }
 // src/definitions/advancement-policies/fluent-rules.ts
@@ -16214,10 +16232,12 @@ class PipelineStepAdvancementBuilder {
   inputSchema;
   meta;
   steps;
-  constructor(inputSchema, meta3, steps) {
+  pipelineInputBindings;
+  constructor(inputSchema, meta3, steps, pipelineInputBindings = {}) {
     this.inputSchema = inputSchema;
     this.meta = meta3;
     this.steps = steps;
+    this.pipelineInputBindings = pipelineInputBindings;
   }
   advance(callback) {
     const last = this.steps.at(-1);
@@ -16228,7 +16248,7 @@ class PipelineStepAdvancementBuilder {
       ...result.rules !== undefined ? { rules: result.rules } : {}
     };
     last.advancement = policy;
-    return new PipelineStepBuilder(this.inputSchema, this.meta, this.steps);
+    return new PipelineStepBuilder(this.inputSchema, this.meta, this.steps, this.pipelineInputBindings);
   }
 }
 
@@ -16236,10 +16256,12 @@ class PipelineStepBuilder {
   inputSchema;
   meta;
   steps;
-  constructor(inputSchema, meta3, steps) {
+  pipelineInputBindings;
+  constructor(inputSchema, meta3, steps, pipelineInputBindings = {}) {
     this.inputSchema = inputSchema;
     this.meta = meta3;
     this.steps = steps;
+    this.pipelineInputBindings = pipelineInputBindings;
   }
   step(step, mapper, configFn) {
     const ctx = makeStepInputCtx(this.inputSchema);
@@ -16253,7 +16275,7 @@ class PipelineStepBuilder {
         stepConfig.timeout = cfg.timeout;
     }
     this.steps.push(stepConfig);
-    return new PipelineStepAdvancementBuilder(this.inputSchema, this.meta, this.steps);
+    return new PipelineStepAdvancementBuilder(this.inputSchema, this.meta, this.steps, this.pipelineInputBindings);
   }
   build() {
     const config2 = {
@@ -16263,7 +16285,8 @@ class PipelineStepBuilder {
       version: this.meta.version,
       status: this.meta.status,
       input: this.inputSchema,
-      steps: this.steps
+      steps: this.steps,
+      pipelineInputBindings: this.pipelineInputBindings
     };
     return buildPipelineSpec(config2);
   }
@@ -16273,10 +16296,27 @@ class PipelineBuilder {
   inputSchema;
   meta;
   steps = [];
+  pipelineInputBindings;
   constructor(meta3) {
-    const { input, ...rest } = meta3;
-    this.inputSchema = input ?? exports_external.unknown();
+    const { additionalPipelineInput, ...rest } = meta3;
+    this.inputSchema = additionalPipelineInput?.schema ?? exports_external.unknown();
     this.meta = rest;
+    if (additionalPipelineInput) {
+      const raw = additionalPipelineInput.bindings({
+        workItem: WORK_ITEM_ACCESSOR,
+        literal: literal2
+      });
+      if (additionalPipelineInput.schema instanceof exports_external.ZodObject) {
+        const validKeys = new Set(Object.keys(additionalPipelineInput.schema.shape));
+        const unknown2 = Object.keys(raw).filter((k) => !validKeys.has(k));
+        if (unknown2.length > 0) {
+          throw new Error(`additionalPipelineInput.bindings returned key${unknown2.length > 1 ? "s" : ""} not in schema: ${unknown2.map((k) => `"${k}"`).join(", ")}`);
+        }
+      }
+      this.pipelineInputBindings = normalizeInputMapping(raw) ?? {};
+    } else {
+      this.pipelineInputBindings = {};
+    }
   }
   step(step, mapper, configFn) {
     const ctx = makeStepInputCtx(this.inputSchema);
@@ -16290,7 +16330,7 @@ class PipelineBuilder {
         stepConfig.timeout = cfg.timeout;
     }
     this.steps.push(stepConfig);
-    return new PipelineStepAdvancementBuilder(this.inputSchema, this.meta, this.steps);
+    return new PipelineStepAdvancementBuilder(this.inputSchema, this.meta, this.steps, this.pipelineInputBindings);
   }
 }
 var WORK_ITEM_ACCESSOR = Object.freeze({
@@ -16298,20 +16338,37 @@ var WORK_ITEM_ACCESSOR = Object.freeze({
   description: Object.freeze({
     source: "work_item",
     field: "description"
-  })
+  }),
+  field: (fieldName) => Object.freeze({ source: "work_item", field: `fields.${fieldName}` })
 });
+var WORK_ITEM_FIELD_BINDINGS = {
+  workItemTitle: { source: "work_item", field: "title" },
+  workItemDescription: { source: "work_item", field: "description" }
+};
 function makeStepInputCtx(inputSchema) {
+  const baseAccessor = createInputAccessor(inputSchema);
+  const input = new Proxy(baseAccessor, {
+    get(target, prop) {
+      if (typeof prop === "string" && prop in WORK_ITEM_FIELD_BINDINGS) {
+        return WORK_ITEM_FIELD_BINDINGS[prop];
+      }
+      return target[prop];
+    }
+  });
   return {
-    input: createInputAccessor(inputSchema),
-    workItem: WORK_ITEM_ACCESSOR,
+    input,
     signal(step, key) {
       return { source: "step_signal", step, signalKey: key };
     },
     output(step) {
       return { source: "step_output", step };
-    }
+    },
+    literal: literal2
   };
 }
+function literal2(value) {
+  return { source: "literal", value };
+}
 function normalizeInputMapping(mapping) {
   if (!mapping)
     return;
@@ -16719,6 +16776,7 @@ export {
   openCodeMcpLocalConfigSchema,
   openCodeMcpEnabledOverrideSchema,
   materializeAccessor,
+  literal2 as literal,
   isInputAccessor,
   defineStep,
   createStepExecutionPlaneClient,

package/dist/push/index.js

@@ -15963,6 +15963,9 @@ function serializeBinding(binding) {
       signalKey: binding.signalKey
     };
   }
+  if (binding.source === "literal") {
+    return { source: "literal", value: binding.value };
+  }
   return { source: "step_output", stepKey: binding.step.key };
 }
 function buildPipelineSpec(config2) {
@@ -15990,16 +15993,31 @@ function buildPipelineSpec(config2) {
     status: config2.status ?? "active",
     inputSchemaJson,
     _stepDefinitions: [...stepDefMap.values()],
-    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),
-      computedSignalDefinitions: extractInlineComputedSignals(stepConfig.advancement)
-    }))
+    steps: steps.map((stepConfig, index) => {
+      const autoBindings = {
+        workItemTitle: { source: "work_item", field: "title" },
+        workItemDescription: { source: "work_item", field: "description" }
+      };
+      const pipelineBindings = {};
+      for (const [key, binding] of Object.entries(config2.pipelineInputBindings ?? {})) {
+        pipelineBindings[key] = serializeBinding(binding);
+      }
+      const explicitStepBindings = Object.fromEntries(Object.entries(stepConfig.input ?? {}).filter((entry) => entry[1] !== undefined).map(([key, binding]) => [key, serializeBinding(binding)]));
+      return {
+        stepKey: stepConfig.step.key,
+        stepName: stepConfig.step.name,
+        stepDescription: stepConfig.step.description,
+        position: index + 1,
+        inputBindingsJson: {
+          ...autoBindings,
+          ...pipelineBindings,
+          ...explicitStepBindings
+        },
+        timeoutSeconds: stepConfig.timeout ?? null,
+        advancementPolicyDefinition: serializeAdvancementPolicy(stepConfig.advancement),
+        computedSignalDefinitions: extractInlineComputedSignals(stepConfig.advancement)
+      };
+    })
   };
 }
 // src/definitions/advancement-policies/fluent-rules.ts
@@ -16144,10 +16162,12 @@ class PipelineStepAdvancementBuilder {
   inputSchema;
   meta;
   steps;
-  constructor(inputSchema, meta3, steps) {
+  pipelineInputBindings;
+  constructor(inputSchema, meta3, steps, pipelineInputBindings = {}) {
     this.inputSchema = inputSchema;
     this.meta = meta3;
     this.steps = steps;
+    this.pipelineInputBindings = pipelineInputBindings;
   }
   advance(callback) {
     const last = this.steps.at(-1);
@@ -16158,7 +16178,7 @@ class PipelineStepAdvancementBuilder {
       ...result.rules !== undefined ? { rules: result.rules } : {}
     };
     last.advancement = policy;
-    return new PipelineStepBuilder(this.inputSchema, this.meta, this.steps);
+    return new PipelineStepBuilder(this.inputSchema, this.meta, this.steps, this.pipelineInputBindings);
   }
 }
 
@@ -16166,10 +16186,12 @@ class PipelineStepBuilder {
   inputSchema;
   meta;
   steps;
-  constructor(inputSchema, meta3, steps) {
+  pipelineInputBindings;
+  constructor(inputSchema, meta3, steps, pipelineInputBindings = {}) {
     this.inputSchema = inputSchema;
     this.meta = meta3;
     this.steps = steps;
+    this.pipelineInputBindings = pipelineInputBindings;
   }
   step(step, mapper, configFn) {
     const ctx = makeStepInputCtx(this.inputSchema);
@@ -16183,7 +16205,7 @@ class PipelineStepBuilder {
         stepConfig.timeout = cfg.timeout;
     }
     this.steps.push(stepConfig);
-    return new PipelineStepAdvancementBuilder(this.inputSchema, this.meta, this.steps);
+    return new PipelineStepAdvancementBuilder(this.inputSchema, this.meta, this.steps, this.pipelineInputBindings);
   }
   build() {
     const config2 = {
@@ -16193,7 +16215,8 @@ class PipelineStepBuilder {
       version: this.meta.version,
       status: this.meta.status,
       input: this.inputSchema,
-      steps: this.steps
+      steps: this.steps,
+      pipelineInputBindings: this.pipelineInputBindings
     };
     return buildPipelineSpec(config2);
   }
@@ -16203,10 +16226,27 @@ class PipelineBuilder {
   inputSchema;
   meta;
   steps = [];
+  pipelineInputBindings;
   constructor(meta3) {
-    const { input, ...rest } = meta3;
-    this.inputSchema = input ?? exports_external.unknown();
+    const { additionalPipelineInput, ...rest } = meta3;
+    this.inputSchema = additionalPipelineInput?.schema ?? exports_external.unknown();
     this.meta = rest;
+    if (additionalPipelineInput) {
+      const raw = additionalPipelineInput.bindings({
+        workItem: WORK_ITEM_ACCESSOR,
+        literal: literal2
+      });
+      if (additionalPipelineInput.schema instanceof exports_external.ZodObject) {
+        const validKeys = new Set(Object.keys(additionalPipelineInput.schema.shape));
+        const unknown2 = Object.keys(raw).filter((k) => !validKeys.has(k));
+        if (unknown2.length > 0) {
+          throw new Error(`additionalPipelineInput.bindings returned key${unknown2.length > 1 ? "s" : ""} not in schema: ${unknown2.map((k) => `"${k}"`).join(", ")}`);
+        }
+      }
+      this.pipelineInputBindings = normalizeInputMapping(raw) ?? {};
+    } else {
+      this.pipelineInputBindings = {};
+    }
   }
   step(step, mapper, configFn) {
     const ctx = makeStepInputCtx(this.inputSchema);
@@ -16220,7 +16260,7 @@ class PipelineBuilder {
         stepConfig.timeout = cfg.timeout;
     }
     this.steps.push(stepConfig);
-    return new PipelineStepAdvancementBuilder(this.inputSchema, this.meta, this.steps);
+    return new PipelineStepAdvancementBuilder(this.inputSchema, this.meta, this.steps, this.pipelineInputBindings);
   }
 }
 var WORK_ITEM_ACCESSOR = Object.freeze({
@@ -16228,20 +16268,37 @@ var WORK_ITEM_ACCESSOR = Object.freeze({
   description: Object.freeze({
     source: "work_item",
     field: "description"
-  })
+  }),
+  field: (fieldName) => Object.freeze({ source: "work_item", field: `fields.${fieldName}` })
 });
+var WORK_ITEM_FIELD_BINDINGS = {
+  workItemTitle: { source: "work_item", field: "title" },
+  workItemDescription: { source: "work_item", field: "description" }
+};
 function makeStepInputCtx(inputSchema) {
+  const baseAccessor = createInputAccessor(inputSchema);
+  const input = new Proxy(baseAccessor, {
+    get(target, prop) {
+      if (typeof prop === "string" && prop in WORK_ITEM_FIELD_BINDINGS) {
+        return WORK_ITEM_FIELD_BINDINGS[prop];
+      }
+      return target[prop];
+    }
+  });
   return {
-    input: createInputAccessor(inputSchema),
-    workItem: WORK_ITEM_ACCESSOR,
+    input,
     signal(step, key) {
       return { source: "step_signal", step, signalKey: key };
     },
     output(step) {
       return { source: "step_output", step };
-    }
+    },
+    literal: literal2
   };
 }
+function literal2(value) {
+  return { source: "literal", value };
+}
 function normalizeInputMapping(mapping) {
   if (!mapping)
     return;

package/package.json

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