@boboddy/sdk 0.1.13-alpha → 0.1.15-alpha

package/dist/definitions/pipelines/input-accessor.d.ts

@@ -0,0 +1,25 @@
+import type { ZodType } from "zod";
+import type { PipelineInputBinding } from "./define-pipeline";
+type DeepAccessor<T> = T extends ReadonlyArray<infer U> ? {
+    readonly [index: number]: InputAccessor<U>;
+} : T extends object ? {
+    readonly [K in keyof T]: InputAccessor<T[K]>;
+} : object;
+/**
+ * Type-level shape of the input accessor. Claims to be a `PipelineInputBinding`
+ * so it slots into binding positions for type-checking; the actual binding
+ * object is produced at builder time via `materializeAccessor`.
+ */
+export type InputAccessor<T> = PipelineInputBinding & DeepAccessor<T>;
+/**
+ * Creates a recursive proxy bound to the pipeline's input schema. Each property
+ * access returns a new accessor whose `materializeAccessor()` yields a
+ * `PipelineInputBinding` with the accumulated dot-path.
+ *
+ * The schema argument is used only for type inference — no runtime validation
+ * is performed against it.
+ */
+export declare function createInputAccessor<T extends ZodType>(_schema: T): InputAccessor<T["_output"]>;
+export declare function isInputAccessor(value: unknown): value is InputAccessor<unknown>;
+export declare function materializeAccessor(accessor: InputAccessor<unknown>): PipelineInputBinding;
+export {};

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

@@ -1,56 +1,243 @@
-import type { SerializedAdvancementPolicy } from "../advancement-policies/define-advancement-policy";
+import { PipelineDefinitions } from "../../generated/sdk.gen";
+import type { PutApiLinearPipelineDefinitionsData } from "../../generated/types.gen";
+import type { PipelineDefinitionSpec } from "./define-pipeline";
 type RequestOptions = {
-    headers?: Record<string, unknown>;
+    headers?: Record<string, unknown> | undefined;
 };
-export type PipelineStepCreateInput = {
-    stepDefinitionId: string;
-    stepDefinitionVersion: number;
-    key: string;
-    name: string;
-    description: string | null;
-    position: number;
-    inputBindingsJson: Record<string, unknown>;
-    timeoutSeconds: number | null;
-    retryPolicyJson: null;
-    advancementPolicyDefinition: SerializedAdvancementPolicy;
-};
-export type CreatePipelineInput = {
-    projectId: string;
-    key: string;
-    name: string;
-    description: string | null;
-    version: number;
-    status: "draft" | "active" | "archived";
-    stepDefinitions: PipelineStepCreateInput[];
-};
-export type UpdatePipelineInput = {
-    projectId: string;
-    key: string;
-    name: string;
-    description: string | null;
-    version: number;
-    status: "draft" | "active" | "archived";
-};
-export type ExistingPipelineStep = {
-    id: string;
-    key: string;
-};
-export type ExistingPipeline = {
+export type UpsertPipelineDefinitionInput = PutApiLinearPipelineDefinitionsData["body"];
+export type StepDefinitionRef = {
     id: string;
     key: string;
     version: number;
-    status: string;
-    steps: ExistingPipelineStep[];
 };
 export declare function createPipelineDefinitionsClient(baseUrl: string): ReturnType<typeof buildPipelineDefinitionsClient>;
-declare const buildPipelineDefinitionsClient: (_base: string, doFetch: (path: string, method: string, headers: Record<string, string>, body?: unknown) => Promise<unknown>) => {
-    listByProjectId: (projectId: string, options?: RequestOptions) => Promise<ExistingPipeline[]>;
-    create: (body: CreatePipelineInput, options?: RequestOptions) => Promise<{
+declare const buildPipelineDefinitionsClient: (pipelineDefinitions: PipelineDefinitions) => {
+    listByProjectId: (projectId: string, options?: RequestOptions) => Promise<{
+        id: string;
+        projectId: string;
+        key: string;
+        name: string;
+        description: string | unknown;
+        status: "draft" | "active" | "archived";
+        archivedAt: string | unknown;
+        inputSchemaJson: unknown;
+        stepDefinitions: Array<{
+            id: string;
+            linearPipelineDefinitionId: string;
+            stepDefinitionId: string;
+            stepDefinitionVersion: number;
+            key: string;
+            name: string;
+            description: string | unknown;
+            position: number;
+            inputBindingsJson: {
+                [key: string]: {
+                    source: string;
+                    path: string | unknown;
+                } | {
+                    source: string;
+                    field: "title" | "description";
+                } | {
+                    source: string;
+                    stepKey: string;
+                    path: string | unknown;
+                } | {
+                    source: string;
+                    stepKey: string;
+                    signalKey: string;
+                } | {
+                    source: string;
+                    value: unknown;
+                };
+            } | unknown;
+            timeoutSeconds: number | unknown;
+            retryPolicyJson: unknown;
+            advancementPolicyDefinition: {
+                id: string;
+                linearPipelineStepDefinitionId: string;
+                rulesJson: {
+                    rules: Array<{
+                        conditions: {
+                            [key: string]: unknown;
+                        };
+                        event: {
+                            type: string;
+                            params?: {
+                                [key: string]: unknown;
+                            };
+                        };
+                        name?: string;
+                        priority?: number;
+                        [key: string]: unknown | {
+                            [key: string]: unknown;
+                        } | {
+                            type: string;
+                            params?: {
+                                [key: string]: unknown;
+                            };
+                        } | string | number | undefined;
+                    }>;
+                    [key: string]: unknown | Array<{
+                        conditions: {
+                            [key: string]: unknown;
+                        };
+                        event: {
+                            type: string;
+                            params?: {
+                                [key: string]: unknown;
+                            };
+                        };
+                        name?: string;
+                        priority?: number;
+                        [key: string]: unknown | {
+                            [key: string]: unknown;
+                        } | {
+                            type: string;
+                            params?: {
+                                [key: string]: unknown;
+                            };
+                        } | string | number | undefined;
+                    }>;
+                };
+                defaultEventType: "continue" | "block" | "complete" | "route";
+                defaultEventParamsJson: unknown;
+                allowedEventTypes: Array<"continue" | "block" | "complete" | "route">;
+                createdAt: string;
+                updatedAt: string;
+            };
+            computedSignalDefinitions: Array<{
+                id: string;
+                key: string;
+                type: "average" | "weighted_average" | "sum" | "min" | "max" | "count" | "boolean_any" | "boolean_all";
+                inputSignalKeys: Array<string>;
+                configJson: unknown;
+                availableWhenResultStatusIn: Array<string> | unknown;
+                createdAt: string;
+                updatedAt: string;
+            }>;
+            createdAt: string;
+            updatedAt: string;
+        }>;
+        createdAt: string;
+        updatedAt: string;
+    }[]>;
+    /**
+     * Upserts a pipeline definition keyed by (projectId, key). Accepts the
+     * `PipelineDefinitionSpec` produced by `pipeline().build()`, along with the
+     * list of pushed step definitions (used to resolve `stepDefinitionId` for
+     * each pipeline step).
+     *
+     * Throws if any pipeline step references a step key/version that isn't
+     * present in `stepDefs`.
+     */
+    upsertFromSpec: (projectId: string, spec: PipelineDefinitionSpec, stepDefs: ReadonlyArray<StepDefinitionRef>, options?: RequestOptions) => Promise<{
         id: string;
+        projectId: string;
         key: string;
+        name: string;
+        description: string | unknown;
+        status: "draft" | "active" | "archived";
+        archivedAt: string | unknown;
+        inputSchemaJson: unknown;
+        stepDefinitions: Array<{
+            id: string;
+            linearPipelineDefinitionId: string;
+            stepDefinitionId: string;
+            stepDefinitionVersion: number;
+            key: string;
+            name: string;
+            description: string | unknown;
+            position: number;
+            inputBindingsJson: {
+                [key: string]: {
+                    source: string;
+                    path: string | unknown;
+                } | {
+                    source: string;
+                    field: "title" | "description";
+                } | {
+                    source: string;
+                    stepKey: string;
+                    path: string | unknown;
+                } | {
+                    source: string;
+                    stepKey: string;
+                    signalKey: string;
+                } | {
+                    source: string;
+                    value: unknown;
+                };
+            } | unknown;
+            timeoutSeconds: number | unknown;
+            retryPolicyJson: unknown;
+            advancementPolicyDefinition: {
+                id: string;
+                linearPipelineStepDefinitionId: string;
+                rulesJson: {
+                    rules: Array<{
+                        conditions: {
+                            [key: string]: unknown;
+                        };
+                        event: {
+                            type: string;
+                            params?: {
+                                [key: string]: unknown;
+                            };
+                        };
+                        name?: string;
+                        priority?: number;
+                        [key: string]: unknown | {
+                            [key: string]: unknown;
+                        } | {
+                            type: string;
+                            params?: {
+                                [key: string]: unknown;
+                            };
+                        } | string | number | undefined;
+                    }>;
+                    [key: string]: unknown | Array<{
+                        conditions: {
+                            [key: string]: unknown;
+                        };
+                        event: {
+                            type: string;
+                            params?: {
+                                [key: string]: unknown;
+                            };
+                        };
+                        name?: string;
+                        priority?: number;
+                        [key: string]: unknown | {
+                            [key: string]: unknown;
+                        } | {
+                            type: string;
+                            params?: {
+                                [key: string]: unknown;
+                            };
+                        } | string | number | undefined;
+                    }>;
+                };
+                defaultEventType: "continue" | "block" | "complete" | "route";
+                defaultEventParamsJson: unknown;
+                allowedEventTypes: Array<"continue" | "block" | "complete" | "route">;
+                createdAt: string;
+                updatedAt: string;
+            };
+            computedSignalDefinitions: Array<{
+                id: string;
+                key: string;
+                type: "average" | "weighted_average" | "sum" | "min" | "max" | "count" | "boolean_any" | "boolean_all";
+                inputSignalKeys: Array<string>;
+                configJson: unknown;
+                availableWhenResultStatusIn: Array<string> | unknown;
+                createdAt: string;
+                updatedAt: string;
+            }>;
+            createdAt: string;
+            updatedAt: string;
+        }>;
+        createdAt: string;
+        updatedAt: string;
     }>;
-    update: (pipelineId: string, body: UpdatePipelineInput, options?: RequestOptions) => Promise<void>;
-    addStep: (pipelineId: string, body: PipelineStepCreateInput, options?: RequestOptions) => Promise<void>;
-    removeStep: (pipelineId: string, stepId: string, options?: RequestOptions) => Promise<void>;
 };
 export {};

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 PromptInputProxy } from "./prompt-template";
 type OpenCodeMcpServers = Record<string, {
     type: "local";
     command: string[];
@@ -48,7 +49,7 @@ export type DefineStepInput<TInput extends ZodType = ZodType, TResult extends Zo
     name: string;
     description?: string | null;
     version?: number;
-    prompt?: string | null;
+    prompt?: string | null | ((input: PromptInputProxy<TInput["_output"]>) => string);
     input?: TInput;
     result?: TResult;
     signals?: SignalSpecInput<TResult["_output"]>[];
@@ -75,10 +76,19 @@ export type StepDefinitionSpec = {
     }>;
     opencodeMcpJson: OpenCodeMcpServers | null;
 };
-export type TypedStepDefinitionSpec<TInput = unknown, TResult = unknown, TSignalKeys extends string = string> = StepDefinitionSpec & {
+export type SignalTypeStrToTs<T extends SignalTypeStr> = T extends "string" ? string : T extends "number" ? number : T extends "boolean" ? boolean : T extends "array" ? unknown[] : T extends "object" ? object : unknown;
+export type SignalTypeMapOf<TSignals extends readonly unknown[], TResult> = {
+    [S in TSignals[number] as ExtractSignalKey<S>]: S extends {
+        type: infer T extends SignalTypeStr;
+    } ? SignalTypeStrToTs<T> : S extends {
+        sourcePath: infer P extends string;
+    } ? TypeAtPath<TResult, P> : unknown;
+};
+export type TypedStepDefinitionSpec<TInput = unknown, TResult = unknown, TSignalKeys extends string = string, TSignalTypeMap extends Partial<Record<string, unknown>> = Record<string, unknown>> = StepDefinitionSpec & {
     readonly __inputType: TInput;
     readonly __resultType: TResult;
     readonly __signalKeys: TSignalKeys;
+    readonly __signalTypeMap: TSignalTypeMap;
 };
 type ExtractSignalKey<T> = T extends {
     key: infer K extends string;
@@ -86,8 +96,11 @@ type ExtractSignalKey<T> = T extends {
     sourcePath: infer S extends string;
 } ? S : string;
 export type SignalKeysOf<TSignals extends readonly unknown[]> = TSignals extends readonly (infer S)[] ? ExtractSignalKey<S> : string;
-export declare function defineStep<TInput extends ZodType = ZodType, TResult extends ZodType = ZodType, const TSignals extends ReadonlyArray<SignalSpecInput<TResult["_output"]>> = never[], const TFeatures extends ReadonlyArray<AnyStepFeature> = never[]>(config: Omit<DefineStepInput<TInput, TResult>, "signals" | "features"> & {
+export declare function defineStep<TInput extends ZodType = ZodType, TResult extends ZodType = ZodType, const TSignals extends ReadonlyArray<{
+    sourcePath: string;
+    key?: string;
+}> = never[], const TFeatures extends ReadonlyArray<AnyStepFeature> = never[]>(config: Omit<DefineStepInput<TInput, TResult>, "signals" | "features"> & {
     signals?: TSignals;
     features?: TFeatures;
-}): TypedStepDefinitionSpec<TInput["_output"], TResult["_output"] & FeatureResultExtensions<TFeatures>, SignalKeysOf<TSignals> | FeatureSignalKeys<TFeatures>>;
+}): TypedStepDefinitionSpec<TInput["_output"], TResult["_output"] & FeatureResultExtensions<TFeatures>, SignalKeysOf<TSignals> | FeatureSignalKeys<TFeatures>, SignalTypeMapOf<TSignals, TResult["_output"]>>;
 export {};

package/dist/definitions/steps/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./define-step";
+export * from "./prompt-template";
 export * from "./step-definitions-client";
 export * from "./step-features";