@boboddy/sdk 0.0.7-alpha → 0.0.8-alpha

package/dist/packages/core/src/work-items/work-item/application/upsert-work-item.d.ts

@@ -0,0 +1,16 @@
+import type { DbExecutor } from "@boboddy/core/lib/db/db-executor";
+import type { UuidV7 } from "@boboddy/core/common/contracts/uuid-v7";
+import type { AuthorizationService } from "@boboddy/core/access/authorization/application/authorization-service";
+import { type WorkItemContract, type UpsertWorkItemInput, type UpsertWorkItemsInput } from "../contracts/work-item-contracts";
+import type { WorkItemRepo } from "./work-item-repo";
+import type { TimeProvider } from "@boboddy/core/lib/time-provider";
+type UpsertWorkItemsDeps = {
+    userId: UuidV7;
+    authz: AuthorizationService;
+    workItemRepo: WorkItemRepo;
+    timeProvider: TimeProvider;
+    dbExecutor?: DbExecutor | undefined;
+};
+export declare const upsertWorkItems: (input: UpsertWorkItemsInput, deps: UpsertWorkItemsDeps) => Promise<WorkItemContract[]>;
+export declare const upsertWorkItem: (input: UpsertWorkItemInput, deps: UpsertWorkItemsDeps) => Promise<WorkItemContract>;
+export {};

package/dist/packages/core/src/work-items/work-item/application/work-item-contract-mapper.d.ts

@@ -0,0 +1,4 @@
+import type { CreateWorkItemProps, WorkItemEntity } from "../domain/work-item-entity";
+import { type WorkItemContract, type UpsertWorkItemInput } from "../contracts/work-item-contracts";
+export declare const upsertWorkItemInputToCreateWorkItemProps: (input: UpsertWorkItemInput) => CreateWorkItemProps;
+export declare const workItemEntityToContract: (workItem: WorkItemEntity) => WorkItemContract;

package/dist/packages/core/src/work-items/work-item/application/work-item-repo.d.ts

@@ -0,0 +1,27 @@
+import type { DbExecutor } from "@boboddy/core/lib/db/db-executor";
+import type { UuidV7 } from "@boboddy/core/common/contracts/uuid-v7";
+import type { WorkItemEntity } from "../domain/work-item-entity";
+import type { WorkItemId } from "../domain/work-item-id";
+import type { WorkItemPlatform } from "../domain/work-item-platform";
+import type { WorkItemProjectionFingerprintEntity } from "../domain/work-item-projection-fingerprint-entity";
+export type WorkItemRepo = {
+    load(id: WorkItemId, dbExecutor?: DbExecutor): Promise<WorkItemEntity | null>;
+    loadMany(ids: WorkItemId[], dbExecutor?: DbExecutor): Promise<WorkItemEntity[]>;
+    loadByProjectId(projectId: UuidV7, dbExecutor?: DbExecutor): Promise<WorkItemEntity[]>;
+    loadByPlatformIdentity(projectId: UuidV7, platform: WorkItemPlatform, sourceIdentity: string, dbExecutor?: DbExecutor): Promise<WorkItemEntity | null>;
+    loadManyByPlatformIdentities(identities: {
+        projectId: UuidV7;
+        platform: WorkItemPlatform;
+        sourceIdentity: string;
+    }[], dbExecutor?: DbExecutor): Promise<WorkItemEntity[]>;
+    create(workItem: WorkItemEntity, dbExecutor?: DbExecutor): Promise<WorkItemEntity>;
+    createMany(workItems: WorkItemEntity[], dbExecutor?: DbExecutor): Promise<WorkItemEntity[]>;
+    save(workItem: WorkItemEntity, dbExecutor?: DbExecutor): Promise<WorkItemEntity>;
+    saveMany(workItems: WorkItemEntity[], dbExecutor?: DbExecutor): Promise<WorkItemEntity[]>;
+    delete(id: WorkItemId, dbExecutor?: DbExecutor): Promise<number>;
+    deleteMany(ids: WorkItemId[], dbExecutor?: DbExecutor): Promise<number>;
+};
+export type WorkItemProjectionFingerprintRepo = {
+    load(workItemId: WorkItemId, specId: string, dbExecutor?: DbExecutor): Promise<WorkItemProjectionFingerprintEntity | null>;
+    save(fingerprint: WorkItemProjectionFingerprintEntity, dbExecutor?: DbExecutor): Promise<WorkItemProjectionFingerprintEntity>;
+};

package/dist/packages/core/src/work-items/work-item/contracts/work-item-contracts.d.ts

@@ -0,0 +1,119 @@
+import { z } from "zod";
+export declare const workItemIdSchema: z.ZodString & z.ZodType<import("../domain/work-item-id").WorkItemId, string, z.core.$ZodTypeInternals<import("../domain/work-item-id").WorkItemId, string>>;
+export declare const workItemPlatformSchema: z.ZodEnum<{
+    jira: "jira";
+    github: "github";
+    linear: "linear";
+    boboddy: "boboddy";
+    custom: "custom";
+}>;
+export declare const workItemSchema: z.ZodObject<{
+    id: z.ZodString & z.ZodType<import("@boboddy/core/common/contracts/uuid-v7").UuidV7, string, z.core.$ZodTypeInternals<import("@boboddy/core/common/contracts/uuid-v7").UuidV7, string>>;
+    projectId: z.ZodString & z.ZodType<import("@boboddy/core/common/contracts/uuid-v7").UuidV7, string, z.core.$ZodTypeInternals<import("@boboddy/core/common/contracts/uuid-v7").UuidV7, string>>;
+    platform: z.ZodEnum<{
+        jira: "jira";
+        github: "github";
+        linear: "linear";
+        boboddy: "boboddy";
+        custom: "custom";
+    }>;
+    platformId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    platformKey: z.ZodString;
+    url: z.ZodOptional<z.ZodNullable<z.ZodURL>>;
+    title: z.ZodString;
+    description: z.ZodString;
+    sourceCreatedAt: z.ZodNullable<z.ZodISODateTime>;
+    sourceUpdatedAt: z.ZodNullable<z.ZodISODateTime>;
+    fields: z.ZodNullable<z.ZodType<import("@boboddy/core/common/contracts/json").AnyJsonObject, unknown, z.core.$ZodTypeInternals<import("@boboddy/core/common/contracts/json").AnyJsonObject, unknown>>>;
+    createdAt: z.ZodISODateTime;
+    updatedAt: z.ZodISODateTime;
+}, z.core.$strip>;
+export declare const createWorkItemSchema: z.ZodObject<{
+    description: z.ZodString;
+    projectId: z.ZodString & z.ZodType<import("@boboddy/core/common/contracts/uuid-v7").UuidV7, string, z.core.$ZodTypeInternals<import("@boboddy/core/common/contracts/uuid-v7").UuidV7, string>>;
+    platform: z.ZodEnum<{
+        jira: "jira";
+        github: "github";
+        linear: "linear";
+        boboddy: "boboddy";
+        custom: "custom";
+    }>;
+    platformId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    platformKey: z.ZodString;
+    url: z.ZodOptional<z.ZodNullable<z.ZodURL>>;
+    title: z.ZodString;
+    sourceCreatedAt: z.ZodNullable<z.ZodISODateTime>;
+    sourceUpdatedAt: z.ZodNullable<z.ZodISODateTime>;
+    fields: z.ZodNullable<z.ZodType<import("@boboddy/core/common/contracts/json").AnyJsonObject, unknown, z.core.$ZodTypeInternals<import("@boboddy/core/common/contracts/json").AnyJsonObject, unknown>>>;
+}, z.core.$strip>;
+export declare const workItemIngestionInputSchema: z.ZodObject<{
+    description: z.ZodString;
+    platform: z.ZodEnum<{
+        jira: "jira";
+        github: "github";
+        linear: "linear";
+        boboddy: "boboddy";
+        custom: "custom";
+    }>;
+    platformId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    platformKey: z.ZodString;
+    url: z.ZodOptional<z.ZodNullable<z.ZodURL>>;
+    title: z.ZodString;
+    sourceCreatedAt: z.ZodNullable<z.ZodISODateTime>;
+    sourceUpdatedAt: z.ZodNullable<z.ZodISODateTime>;
+    fields: z.ZodNullable<z.ZodType<import("@boboddy/core/common/contracts/json").AnyJsonObject, unknown, z.core.$ZodTypeInternals<import("@boboddy/core/common/contracts/json").AnyJsonObject, unknown>>>;
+}, z.core.$strip>;
+export declare const upsertWorkItemInputSchema: z.ZodObject<{
+    description: z.ZodString;
+    projectId: z.ZodString & z.ZodType<import("@boboddy/core/common/contracts/uuid-v7").UuidV7, string, z.core.$ZodTypeInternals<import("@boboddy/core/common/contracts/uuid-v7").UuidV7, string>>;
+    platform: z.ZodEnum<{
+        jira: "jira";
+        github: "github";
+        linear: "linear";
+        boboddy: "boboddy";
+        custom: "custom";
+    }>;
+    platformId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    platformKey: z.ZodString;
+    url: z.ZodOptional<z.ZodNullable<z.ZodURL>>;
+    title: z.ZodString;
+    sourceCreatedAt: z.ZodNullable<z.ZodISODateTime>;
+    sourceUpdatedAt: z.ZodNullable<z.ZodISODateTime>;
+    fields: z.ZodNullable<z.ZodType<import("@boboddy/core/common/contracts/json").AnyJsonObject, unknown, z.core.$ZodTypeInternals<import("@boboddy/core/common/contracts/json").AnyJsonObject, unknown>>>;
+}, z.core.$strip>;
+export declare const upsertWorkItemsInputSchema: z.ZodArray<z.ZodObject<{
+    description: z.ZodString;
+    projectId: z.ZodString & z.ZodType<import("@boboddy/core/common/contracts/uuid-v7").UuidV7, string, z.core.$ZodTypeInternals<import("@boboddy/core/common/contracts/uuid-v7").UuidV7, string>>;
+    platform: z.ZodEnum<{
+        jira: "jira";
+        github: "github";
+        linear: "linear";
+        boboddy: "boboddy";
+        custom: "custom";
+    }>;
+    platformId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    platformKey: z.ZodString;
+    url: z.ZodOptional<z.ZodNullable<z.ZodURL>>;
+    title: z.ZodString;
+    sourceCreatedAt: z.ZodNullable<z.ZodISODateTime>;
+    sourceUpdatedAt: z.ZodNullable<z.ZodISODateTime>;
+    fields: z.ZodNullable<z.ZodType<import("@boboddy/core/common/contracts/json").AnyJsonObject, unknown, z.core.$ZodTypeInternals<import("@boboddy/core/common/contracts/json").AnyJsonObject, unknown>>>;
+}, z.core.$strip>>;
+export declare const getWorkItemInputSchema: z.ZodString & z.ZodType<import("../domain/work-item-id").WorkItemId, string, z.core.$ZodTypeInternals<import("../domain/work-item-id").WorkItemId, string>>;
+export declare const getWorkItemsInputSchema: z.ZodArray<z.ZodString & z.ZodType<import("../domain/work-item-id").WorkItemId, string, z.core.$ZodTypeInternals<import("../domain/work-item-id").WorkItemId, string>>>;
+export declare const deleteWorkItemInputSchema: z.ZodString & z.ZodType<import("../domain/work-item-id").WorkItemId, string, z.core.$ZodTypeInternals<import("../domain/work-item-id").WorkItemId, string>>;
+export declare const deleteWorkItemsInputSchema: z.ZodArray<z.ZodString & z.ZodType<import("../domain/work-item-id").WorkItemId, string, z.core.$ZodTypeInternals<import("../domain/work-item-id").WorkItemId, string>>>;
+export declare const workItemProjectionSpecSchema: z.ZodObject<{
+    id: z.ZodString;
+    fields: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type WorkItemContract = z.infer<typeof workItemSchema>;
+export type CreateWorkItemInput = z.input<typeof createWorkItemSchema>;
+export type WorkItemIngestionInput = z.input<typeof workItemIngestionInputSchema>;
+export type UpsertWorkItemInput = z.input<typeof upsertWorkItemInputSchema>;
+export type UpsertWorkItemsInput = z.input<typeof upsertWorkItemsInputSchema>;
+export type GetWorkItemInput = z.input<typeof getWorkItemInputSchema>;
+export type GetWorkItemsInput = z.input<typeof getWorkItemsInputSchema>;
+export type DeleteWorkItemInput = z.input<typeof deleteWorkItemInputSchema>;
+export type DeleteWorkItemsInput = z.input<typeof deleteWorkItemsInputSchema>;
+export type WorkItemProjectionSpecContract = z.infer<typeof workItemProjectionSpecSchema>;

package/dist/packages/core/src/work-items/work-item/domain/date-utils.d.ts

@@ -0,0 +1 @@
+export declare const normalizeDate: (value?: Date | string | null) => Date | null | undefined;

package/dist/packages/core/src/work-items/work-item/domain/work-item-entity.d.ts

@@ -0,0 +1,58 @@
+import { type UuidV7 } from "@boboddy/core/common/contracts/uuid-v7";
+import { type WorkItemFields } from "./work-item-field-value";
+import { type WorkItemId } from "./work-item-id";
+import type { WorkItemPlatform } from "./work-item-platform";
+export type WorkItemEntityProps = {
+    id: WorkItemId;
+    projectId: UuidV7;
+    platform: WorkItemPlatform;
+    platformId?: string | null | undefined;
+    platformKey: string;
+    url?: string | null | undefined;
+    title: string;
+    description?: string | null | undefined;
+    sourceCreatedAt?: Date | string | null | undefined;
+    sourceUpdatedAt?: Date | string | null | undefined;
+    fields?: WorkItemFields | undefined;
+    createdAt?: Date | string | null | undefined;
+    updatedAt?: Date | string | null | undefined;
+};
+export type CreateWorkItemProps = Omit<WorkItemEntityProps, "id" | "createdAt" | "updatedAt"> & {
+    id?: WorkItemId | undefined;
+};
+export declare class WorkItemEntity {
+    readonly id: WorkItemId;
+    readonly projectId: UuidV7;
+    readonly platform: WorkItemPlatform;
+    readonly platformId: string | null;
+    readonly platformKey: string;
+    readonly url: string | null;
+    readonly title: string;
+    readonly description: string | null;
+    readonly sourceCreatedAt: Date | null;
+    readonly sourceUpdatedAt: Date | null;
+    readonly fields: WorkItemFields;
+    readonly createdAt: Date | null | undefined;
+    readonly updatedAt: Date | null | undefined;
+    private constructor();
+    static create(props: CreateWorkItemProps): WorkItemEntity;
+    static rehydrate(props: WorkItemEntityProps): WorkItemEntity;
+    reingest(props: Omit<CreateWorkItemProps, "id">, now?: Date): WorkItemEntity;
+    toJSON(): {
+        id: WorkItemId;
+        projectId: UuidV7;
+        platform: "jira" | "github" | "linear" | "boboddy" | "custom";
+        platformId: string | null;
+        platformKey: string;
+        url: string | null;
+        title: string;
+        description: string | null;
+        sourceCreatedAt: Date | null;
+        sourceUpdatedAt: Date | null;
+        fields: {
+            [x: string]: import("../../../common/contracts/json").AnyJsonValue;
+        };
+        createdAt: Date | null | undefined;
+        updatedAt: Date | null | undefined;
+    };
+}

package/dist/packages/core/src/work-items/work-item/domain/work-item-field-value.d.ts

@@ -0,0 +1,3 @@
+import type { AnyJsonValue } from "@boboddy/core/common/contracts/json";
+export type WorkItemFieldValue = AnyJsonValue;
+export type WorkItemFields = Record<string, WorkItemFieldValue>;

package/dist/packages/core/src/work-items/work-item/domain/work-item-id.d.ts

@@ -0,0 +1,6 @@
+export type WorkItemId = string & {
+    readonly __brand: "WorkItemId";
+};
+export declare const isWorkItemId: (value: string) => value is WorkItemId;
+export declare const parseWorkItemId: (value: string) => WorkItemId;
+export declare const createWorkItemId: () => WorkItemId;

package/dist/packages/core/src/work-items/work-item/domain/work-item-platform.d.ts

@@ -0,0 +1,2 @@
+export declare const WORK_ITEM_PLATFORMS: readonly ["jira", "github", "linear", "boboddy", "custom"];
+export type WorkItemPlatform = (typeof WORK_ITEM_PLATFORMS)[number];

package/dist/packages/core/src/work-items/work-item/domain/work-item-projection-fingerprint-entity.d.ts

@@ -0,0 +1,18 @@
+import { type WorkItemId } from "./work-item-id";
+export type WorkItemProjectionFingerprintProps = {
+    workItemId: WorkItemId;
+    specId: string;
+    fingerprint: string;
+    canonicalContent: string;
+    createdAt?: Date | string | null | undefined;
+    updatedAt?: Date | string | null | undefined;
+};
+export declare class WorkItemProjectionFingerprintEntity {
+    readonly workItemId: WorkItemId;
+    readonly specId: string;
+    readonly fingerprint: string;
+    readonly canonicalContent: string;
+    readonly createdAt: Date | null | undefined;
+    readonly updatedAt: Date | null | undefined;
+    constructor(props: WorkItemProjectionFingerprintProps);
+}

package/dist/packages/core/src/work-items/work-item/infra/drizzle-work-item-repo.d.ts

@@ -0,0 +1,25 @@
+import type { DbExecutor } from "@boboddy/core/lib/db/db-executor";
+import type { UuidV7 } from "@boboddy/core/common/contracts/uuid-v7";
+import { workItems } from "@boboddy/core/lib/db/schema";
+import type { WorkItemRepo } from "../application/work-item-repo";
+import { WorkItemEntity } from "../domain/work-item-entity";
+import { type WorkItemId } from "../domain/work-item-id";
+import type { WorkItemPlatform } from "../domain/work-item-platform";
+export declare class DrizzleWorkItemRepo implements WorkItemRepo {
+    private toEntity;
+    load(id: WorkItemId, dbExecutor?: DbExecutor): Promise<WorkItemEntity | null>;
+    loadMany(ids: WorkItemId[], dbExecutor?: DbExecutor): Promise<WorkItemEntity[]>;
+    loadByProjectId(projectId: UuidV7, dbExecutor?: DbExecutor): Promise<WorkItemEntity[]>;
+    loadByPlatformIdentity(projectId: UuidV7, platform: typeof workItems.$inferSelect.platform, sourceIdentity: string, dbExecutor?: DbExecutor): Promise<WorkItemEntity | null>;
+    loadManyByPlatformIdentities(identities: {
+        projectId: UuidV7;
+        platform: WorkItemPlatform;
+        sourceIdentity: string;
+    }[], dbExecutor?: DbExecutor): Promise<WorkItemEntity[]>;
+    save(workItem: WorkItemEntity, dbExecutor?: DbExecutor): Promise<WorkItemEntity>;
+    create(workItem: WorkItemEntity, dbExecutor?: DbExecutor): Promise<WorkItemEntity>;
+    createMany(workItemEntities: WorkItemEntity[], dbExecutor?: DbExecutor): Promise<WorkItemEntity[]>;
+    saveMany(workItemEntities: WorkItemEntity[], dbExecutor?: DbExecutor): Promise<WorkItemEntity[]>;
+    delete(id: WorkItemId, dbExecutor?: DbExecutor): Promise<number>;
+    deleteMany(ids: WorkItemId[], dbExecutor?: DbExecutor): Promise<number>;
+}

package/dist/packages/sdks/js/src/define-step.d.ts

@@ -0,0 +1,72 @@
+import type { ZodType } from "zod";
+import type { OpenCodeMcpServers } from "@boboddy/core/common/contracts/opencode-mcp";
+type SignalTypeStr = "string" | "number" | "boolean" | "object" | "array";
+type DotPaths<T, D extends readonly unknown[] = []> = D["length"] extends 4 ? string : unknown extends T ? string : T extends readonly unknown[] ? string : T extends object ? {
+    [K in keyof T & string]: K | (NonNullable<T[K]> extends object ? `${K}.${DotPaths<NonNullable<T[K]>, [...D, unknown]> & string}` : never);
+}[keyof T & string] : string;
+type TypeAtPath<T, P extends string> = P extends `${infer K}.${infer Rest}` ? K extends keyof NonNullable<T> ? TypeAtPath<NonNullable<NonNullable<T>[K]>, Rest> : unknown : P extends keyof NonNullable<T> ? NonNullable<T>[P] : unknown;
+type ToSignalType<T> = string extends T ? SignalTypeStr : [T] extends [string] ? "string" : [T] extends [number] ? "number" : [T] extends [boolean] ? "boolean" : [T] extends [readonly unknown[]] ? "array" : [T] extends [object] ? "object" : SignalTypeStr;
+type SignalSpecInput<TOutput> = {
+    [P in DotPaths<TOutput>]: {
+        key?: string;
+        sourcePath: P;
+        type?: ToSignalType<TypeAtPath<TOutput, P>>;
+        required?: boolean;
+        availableWhenResultStatusIn?: string[] | null;
+    };
+}[DotPaths<TOutput>];
+export type StepSignalSpec = {
+    key?: string;
+    sourcePath: string;
+    type: SignalTypeStr;
+    required?: boolean;
+    availableWhenResultStatusIn?: string[] | null;
+};
+export type StepComputedSignalSpec = {
+    key: string;
+    type: "average" | "weighted_average" | "sum" | "min" | "max" | "custom";
+    inputSignalKeys: string[];
+    configJson?: Record<string, unknown> | null;
+    availableWhenResultStatusIn?: string[] | null;
+};
+export type DefineStepInput<TInput extends ZodType = ZodType, TResult extends ZodType = ZodType> = {
+    key: string;
+    name: string;
+    description?: string | null;
+    version?: number;
+    prompt?: string | null;
+    input?: TInput;
+    result?: TResult;
+    signals?: SignalSpecInput<TResult["_output"]>[];
+    computedSignals?: StepComputedSignalSpec[];
+    mcpServers?: OpenCodeMcpServers | null;
+    status?: "draft" | "active";
+};
+export type StepDefinitionSpec = {
+    key: string;
+    name: string;
+    description: string | null;
+    version: number;
+    kind: "user_defined";
+    status: "draft" | "active" | "archived";
+    prompt: string | null;
+    inputSchemaJson: Record<string, unknown> | null;
+    resultSchemaJson: Record<string, unknown> | null;
+    signalExtractorDefinitions: Array<{
+        key: string;
+        sourcePath: string;
+        type: SignalTypeStr;
+        required: boolean;
+        availableWhenResultStatusIn: string[] | null;
+    }>;
+    computedSignalDefinitions: Array<{
+        key: string;
+        type: "average" | "weighted_average" | "sum" | "min" | "max" | "custom";
+        inputSignalKeys: string[];
+        configJson: Record<string, unknown> | null;
+        availableWhenResultStatusIn: string[] | null;
+    }>;
+    opencodeMcpJson: OpenCodeMcpServers | null;
+};
+export declare function defineStep<TInput extends ZodType = ZodType, TResult extends ZodType = ZodType>(config: DefineStepInput<TInput, TResult>): StepDefinitionSpec;
+export {};

package/dist/packages/sdks/js/src/step-definitions-client.d.ts

@@ -0,0 +1,202 @@
+import type { App } from "@boboddy/api/app";
+import type { CreateStepDefinitionInput, UpdateStepDefinitionInput } from "@boboddy/core/pipeline-definitions/step-definition/contracts/step-definition-contracts";
+import { createBoboddyTreaty } from "./treaty";
+type RequestOptions = {
+    headers?: Record<string, unknown> | undefined;
+};
+export declare function createStepDefinitionsClient(baseUrlOrApp: string | App): ReturnType<typeof buildStepDefinitionsClient>;
+declare const buildStepDefinitionsClient: (apiClient: ReturnType<typeof createBoboddyTreaty>) => {
+    listByProjectId: (projectId: string, options?: RequestOptions) => Promise<{
+        id: string & {
+            readonly __brand: "uuidv7";
+        };
+        projectId: string & {
+            readonly __brand: "uuidv7";
+        };
+        key: string;
+        name: string;
+        description: string | null;
+        prompt: string | null;
+        version: number;
+        kind: "built_in" | "user_defined";
+        inputSchemaJson: import("@boboddy/core/common/contracts/json").AnyJsonObject | null;
+        resultSchemaJson: import("@boboddy/core/common/contracts/json").AnyJsonObject | null;
+        opencodeMcpJson: Record<string, {
+            type: "local";
+            command: string[];
+            environment?: Record<string, string> | undefined;
+            enabled?: boolean | undefined;
+            timeout?: number | undefined;
+        } | {
+            type: "remote";
+            url: string;
+            enabled?: boolean | undefined;
+            headers?: Record<string, string> | undefined;
+            oauth?: false | {
+                clientId?: string | undefined;
+                clientSecret?: string | undefined;
+                scope?: string | undefined;
+                redirectUri?: string | undefined;
+            } | undefined;
+            timeout?: number | undefined;
+        } | {
+            enabled: boolean;
+        }> | null;
+        status: "draft" | "active" | "archived";
+        signalExtractorDefinitions: {
+            id: string & {
+                readonly __brand: "uuidv7";
+            };
+            key: string;
+            sourcePath: string;
+            type: "string" | "number" | "boolean" | "object" | "array";
+            required: boolean;
+            availableWhenResultStatusIn: string[] | null;
+            createdAt: string;
+            updatedAt: string;
+        }[];
+        computedSignalDefinitions: {
+            id: string & {
+                readonly __brand: "uuidv7";
+            };
+            key: string;
+            type: "custom" | "average" | "weighted_average" | "sum" | "min" | "max";
+            inputSignalKeys: string[];
+            configJson: import("@boboddy/core/common/contracts/json").AnyJsonObject | null;
+            availableWhenResultStatusIn: string[] | null;
+            createdAt: string;
+            updatedAt: string;
+        }[];
+        createdAt: string;
+        updatedAt: string;
+    }[]>;
+    create: (body: CreateStepDefinitionInput, options?: RequestOptions) => Promise<{
+        id: string & {
+            readonly __brand: "uuidv7";
+        };
+        projectId: string & {
+            readonly __brand: "uuidv7";
+        };
+        key: string;
+        name: string;
+        description: string | null;
+        prompt: string | null;
+        version: number;
+        kind: "built_in" | "user_defined";
+        inputSchemaJson: import("@boboddy/core/common/contracts/json").AnyJsonObject | null;
+        resultSchemaJson: import("@boboddy/core/common/contracts/json").AnyJsonObject | null;
+        opencodeMcpJson: Record<string, {
+            type: "local";
+            command: string[];
+            environment?: Record<string, string> | undefined;
+            enabled?: boolean | undefined;
+            timeout?: number | undefined;
+        } | {
+            type: "remote";
+            url: string;
+            enabled?: boolean | undefined;
+            headers?: Record<string, string> | undefined;
+            oauth?: false | {
+                clientId?: string | undefined;
+                clientSecret?: string | undefined;
+                scope?: string | undefined;
+                redirectUri?: string | undefined;
+            } | undefined;
+            timeout?: number | undefined;
+        } | {
+            enabled: boolean;
+        }> | null;
+        status: "draft" | "active" | "archived";
+        signalExtractorDefinitions: {
+            id: string & {
+                readonly __brand: "uuidv7";
+            };
+            key: string;
+            sourcePath: string;
+            type: "string" | "number" | "boolean" | "object" | "array";
+            required: boolean;
+            availableWhenResultStatusIn: string[] | null;
+            createdAt: string;
+            updatedAt: string;
+        }[];
+        computedSignalDefinitions: {
+            id: string & {
+                readonly __brand: "uuidv7";
+            };
+            key: string;
+            type: "custom" | "average" | "weighted_average" | "sum" | "min" | "max";
+            inputSignalKeys: string[];
+            configJson: import("@boboddy/core/common/contracts/json").AnyJsonObject | null;
+            availableWhenResultStatusIn: string[] | null;
+            createdAt: string;
+            updatedAt: string;
+        }[];
+        createdAt: string;
+        updatedAt: string;
+    }>;
+    update: (stepDefinitionId: string, body: UpdateStepDefinitionInput, options?: RequestOptions) => Promise<{
+        id: string & {
+            readonly __brand: "uuidv7";
+        };
+        projectId: string & {
+            readonly __brand: "uuidv7";
+        };
+        key: string;
+        name: string;
+        description: string | null;
+        prompt: string | null;
+        version: number;
+        kind: "built_in" | "user_defined";
+        inputSchemaJson: import("@boboddy/core/common/contracts/json").AnyJsonObject | null;
+        resultSchemaJson: import("@boboddy/core/common/contracts/json").AnyJsonObject | null;
+        opencodeMcpJson: Record<string, {
+            type: "local";
+            command: string[];
+            environment?: Record<string, string> | undefined;
+            enabled?: boolean | undefined;
+            timeout?: number | undefined;
+        } | {
+            type: "remote";
+            url: string;
+            enabled?: boolean | undefined;
+            headers?: Record<string, string> | undefined;
+            oauth?: false | {
+                clientId?: string | undefined;
+                clientSecret?: string | undefined;
+                scope?: string | undefined;
+                redirectUri?: string | undefined;
+            } | undefined;
+            timeout?: number | undefined;
+        } | {
+            enabled: boolean;
+        }> | null;
+        status: "draft" | "active" | "archived";
+        signalExtractorDefinitions: {
+            id: string & {
+                readonly __brand: "uuidv7";
+            };
+            key: string;
+            sourcePath: string;
+            type: "string" | "number" | "boolean" | "object" | "array";
+            required: boolean;
+            availableWhenResultStatusIn: string[] | null;
+            createdAt: string;
+            updatedAt: string;
+        }[];
+        computedSignalDefinitions: {
+            id: string & {
+                readonly __brand: "uuidv7";
+            };
+            key: string;
+            type: "custom" | "average" | "weighted_average" | "sum" | "min" | "max";
+            inputSignalKeys: string[];
+            configJson: import("@boboddy/core/common/contracts/json").AnyJsonObject | null;
+            availableWhenResultStatusIn: string[] | null;
+            createdAt: string;
+            updatedAt: string;
+        }[];
+        createdAt: string;
+        updatedAt: string;
+    }>;
+};
+export {};

package/dist/packages/sdks/js/src/step-execution-plane-client.d.ts

@@ -13,6 +13,7 @@ declare const buildStepExecutionPlaneClient: (apiClient: ReturnType<typeof creat
         workerId: string;
         batchSize: number;
         leaseDurationSeconds: number;
+        workItemId?: string | undefined;
     }, options?: RequestOptions) => Promise<{
         stepExecution: {
             id: string & {

package/dist/packages/sdks/js/test/define-step.test.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@boboddy/sdk",
-  "version": "0.0.7-alpha",
+  "version": "0.0.8-alpha",
   "type": "module",
   "exports": {
     ".": {
@@ -15,6 +15,15 @@
     "./treaty": {
       "import": "./dist/treaty.js",
       "types": "./dist/treaty.d.ts"
+    },
+    "./define-step": {
+      "bun": "./src/define-step.ts",
+      "import": "./dist/define-step.js",
+      "types": "./dist/define-step.d.ts"
+    },
+    "./step-definitions-client": {
+      "import": "./dist/step-definitions-client.js",
+      "types": "./dist/step-definitions-client.d.ts"
     }
   },
   "files": [
@@ -26,13 +35,19 @@
   },
   "scripts": {
     "build": "bun run script/build.ts",
+    "test": "bun test test",
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
   "dependencies": {
+    "@boboddy/core": "workspace:*",
     "@elysiajs/eden": "^1.4.9"
   },
+  "peerDependencies": {
+    "zod": ">=4.0.0"
+  },
   "devDependencies": {
     "@hey-api/openapi-ts": "^0.90.10",
-    "bun-types": "^1.3.12"
+    "bun-types": "^1.3.12",
+    "zod": "^4.3.6"
   }
 }