@boboddy/sdk 0.0.7-alpha → 0.0.8-alpha

package/dist/apps/api/src/http/routes/step-definition-templates.d.ts

@@ -0,0 +1,477 @@
+import { Elysia } from "elysia";
+import type { AppContext } from "@boboddy/core/lib/di";
+export declare const createStepDefinitionTemplateRoutes: (appContext: AppContext) => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {
+    "step-definition-templates": {
+        get: {
+            body: unknown;
+            params: {};
+            query: unknown;
+            headers: unknown;
+            response: {
+                422: {
+                    type: "validation";
+                    on: string;
+                    summary?: string;
+                    message?: string;
+                    found?: unknown;
+                    property?: string;
+                    expected?: string;
+                };
+                500: {
+                    type: string;
+                    title: string;
+                    status: number;
+                    detail?: string | undefined;
+                    instance?: string | undefined;
+                    code?: string | undefined;
+                    errors?: {
+                        path: string;
+                        message: string;
+                        summary?: string | undefined;
+                    }[] | undefined;
+                };
+                200: {
+                    id: string & {
+                        readonly __brand: "uuidv7";
+                    };
+                    key: string;
+                    name: string;
+                    description: string | null;
+                    promptTemplate: string | null;
+                    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;
+                    signalExtractorDefinitions: {
+                        key: string;
+                        sourcePath: string;
+                        type: "string" | "number" | "boolean" | "object" | "array";
+                        required: boolean;
+                        availableWhenResultStatusIn: string[] | null;
+                    }[];
+                    parameters: {
+                        key: string;
+                        label: string;
+                        type: "text" | "textarea";
+                        required: boolean;
+                        description?: string | null | undefined;
+                        placeholder?: string | null | undefined;
+                    }[];
+                    status: "active" | "archived";
+                    createdAt: string;
+                    updatedAt: string;
+                }[];
+                401: {
+                    type: string;
+                    title: string;
+                    status: number;
+                    detail?: string | undefined;
+                    instance?: string | undefined;
+                    code?: string | undefined;
+                    errors?: {
+                        path: string;
+                        message: string;
+                        summary?: string | undefined;
+                    }[] | undefined;
+                };
+            };
+        };
+    };
+} & {
+    "step-definition-templates": {
+        ":stepDefinitionTemplateId": {
+            get: {
+                body: unknown;
+                params: {
+                    stepDefinitionTemplateId: string & {
+                        readonly __brand: "uuidv7";
+                    };
+                };
+                query: unknown;
+                headers: unknown;
+                response: {
+                    422: {
+                        type: string;
+                        title: string;
+                        status: number;
+                        detail?: string | undefined;
+                        instance?: string | undefined;
+                        code?: string | undefined;
+                        errors?: {
+                            path: string;
+                            message: string;
+                            summary?: string | undefined;
+                        }[] | undefined;
+                    };
+                    404: {
+                        type: string;
+                        title: string;
+                        status: number;
+                        detail?: string | undefined;
+                        instance?: string | undefined;
+                        code?: string | undefined;
+                        errors?: {
+                            path: string;
+                            message: string;
+                            summary?: string | undefined;
+                        }[] | undefined;
+                    };
+                    500: {
+                        type: string;
+                        title: string;
+                        status: number;
+                        detail?: string | undefined;
+                        instance?: string | undefined;
+                        code?: string | undefined;
+                        errors?: {
+                            path: string;
+                            message: string;
+                            summary?: string | undefined;
+                        }[] | undefined;
+                    };
+                    200: {
+                        id: string & {
+                            readonly __brand: "uuidv7";
+                        };
+                        key: string;
+                        name: string;
+                        description: string | null;
+                        promptTemplate: string | null;
+                        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;
+                        signalExtractorDefinitions: {
+                            key: string;
+                            sourcePath: string;
+                            type: "string" | "number" | "boolean" | "object" | "array";
+                            required: boolean;
+                            availableWhenResultStatusIn: string[] | null;
+                        }[];
+                        parameters: {
+                            key: string;
+                            label: string;
+                            type: "text" | "textarea";
+                            required: boolean;
+                            description?: string | null | undefined;
+                            placeholder?: string | null | undefined;
+                        }[];
+                        status: "active" | "archived";
+                        createdAt: string;
+                        updatedAt: string;
+                    };
+                    401: {
+                        type: string;
+                        title: string;
+                        status: number;
+                        detail?: string | undefined;
+                        instance?: string | undefined;
+                        code?: string | undefined;
+                        errors?: {
+                            path: string;
+                            message: string;
+                            summary?: string | undefined;
+                        }[] | undefined;
+                    };
+                };
+            };
+        };
+    };
+} & {
+    "step-definition-templates": {
+        ":stepDefinitionTemplateId": {
+            instantiate: {
+                post: {
+                    body: {
+                        projectId: string & {
+                            readonly __brand: "uuidv7";
+                        };
+                        name: string;
+                        parameterValues: Record<string, string>;
+                    };
+                    params: {
+                        stepDefinitionTemplateId: string & {
+                            readonly __brand: "uuidv7";
+                        };
+                    };
+                    query: unknown;
+                    headers: unknown;
+                    response: {
+                        422: {
+                            type: string;
+                            title: string;
+                            status: number;
+                            detail?: string | undefined;
+                            instance?: string | undefined;
+                            code?: string | undefined;
+                            errors?: {
+                                path: string;
+                                message: string;
+                                summary?: string | undefined;
+                            }[] | undefined;
+                        };
+                        404: {
+                            type: string;
+                            title: string;
+                            status: number;
+                            detail?: string | undefined;
+                            instance?: string | undefined;
+                            code?: string | undefined;
+                            errors?: {
+                                path: string;
+                                message: string;
+                                summary?: string | undefined;
+                            }[] | undefined;
+                        };
+                        409: {
+                            type: string;
+                            title: string;
+                            status: number;
+                            detail?: string | undefined;
+                            instance?: string | undefined;
+                            code?: string | undefined;
+                            errors?: {
+                                path: string;
+                                message: string;
+                                summary?: string | undefined;
+                            }[] | undefined;
+                        };
+                        500: {
+                            type: string;
+                            title: string;
+                            status: number;
+                            detail?: string | undefined;
+                            instance?: string | undefined;
+                            code?: string | undefined;
+                            errors?: {
+                                path: string;
+                                message: string;
+                                summary?: string | undefined;
+                            }[] | undefined;
+                        };
+                        200: {
+                            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;
+                        };
+                        403: {
+                            type: string;
+                            title: string;
+                            status: number;
+                            detail?: string | undefined;
+                            instance?: string | undefined;
+                            code?: string | undefined;
+                            errors?: {
+                                path: string;
+                                message: string;
+                                summary?: string | undefined;
+                            }[] | undefined;
+                        };
+                        400: {
+                            type: string;
+                            title: string;
+                            status: number;
+                            detail?: string | undefined;
+                            instance?: string | undefined;
+                            code?: string | undefined;
+                            errors?: {
+                                path: string;
+                                message: string;
+                                summary?: string | undefined;
+                            }[] | undefined;
+                        };
+                        401: {
+                            type: string;
+                            title: string;
+                            status: number;
+                            detail?: string | undefined;
+                            instance?: string | undefined;
+                            code?: string | undefined;
+                            errors?: {
+                                path: string;
+                                message: string;
+                                summary?: string | undefined;
+                            }[] | undefined;
+                        };
+                    };
+                };
+            };
+        };
+    };
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+} & {
+    derive: {
+        readonly auth: {
+            readonly userId: import("@boboddy/core/common/contracts/uuid-v7").UuidV7;
+            readonly user: {
+                id: string;
+                createdAt: Date;
+                updatedAt: Date;
+                email: string;
+                emailVerified: boolean;
+                name: string;
+                image?: string | null | undefined | undefined;
+            };
+            readonly session: {
+                id: string;
+                createdAt: Date;
+                updatedAt: Date;
+                userId: string;
+                expiresAt: Date;
+                token: string;
+                ipAddress?: string | null | undefined | undefined;
+                userAgent?: string | null | undefined | undefined;
+            };
+        };
+    };
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: import("elysia").ExtractErrorFromHandle<{
+        readonly auth: {
+            readonly userId: import("@boboddy/core/common/contracts/uuid-v7").UuidV7;
+            readonly user: {
+                id: string;
+                createdAt: Date;
+                updatedAt: Date;
+                email: string;
+                emailVerified: boolean;
+                name: string;
+                image?: string | null | undefined | undefined;
+            };
+            readonly session: {
+                id: string;
+                createdAt: Date;
+                updatedAt: Date;
+                userId: string;
+                expiresAt: Date;
+                token: string;
+                ipAddress?: string | null | undefined | undefined;
+                userAgent?: string | null | undefined | undefined;
+            };
+        };
+    }>;
+}>;

package/dist/apps/api/src/http/routes/step-executions.d.ts

@@ -26,6 +26,7 @@ export declare const createStepExecutionsRoutes: (appContext: AppContext) => Ely
                     workerId: string;
                     batchSize: number;
                     leaseDurationSeconds: number;
+                    workItemId?: string | undefined;
                 };
                 params: {};
                 query: unknown;

package/dist/packages/core/src/access/authorization/application/authorization-service.d.ts

@@ -0,0 +1,12 @@
+import type { UuidV7 } from "@boboddy/core/common/contracts/uuid-v7";
+import type { DbExecutor } from "@boboddy/core/lib/db/db-executor";
+import type { ProjectPermission } from "@boboddy/core/projects/project/domain/project-permission";
+export type RequireProjectPermissionInput = {
+    actorId: UuidV7;
+    projectId: UuidV7;
+    permission: ProjectPermission;
+    dbExecutor?: DbExecutor | undefined;
+};
+export interface AuthorizationService {
+    requireProjectPermission(input: RequireProjectPermissionInput): Promise<void>;
+}

package/dist/packages/core/src/access/authorization/infra/project-authorization-service.d.ts

@@ -0,0 +1,7 @@
+import type { ProjectRepo } from "@boboddy/core/projects/project/application/project-repo";
+import type { AuthorizationService, RequireProjectPermissionInput } from "../application/authorization-service";
+export declare class ProjectAuthorizationService implements AuthorizationService {
+    private readonly projectRepo;
+    constructor(projectRepo: ProjectRepo);
+    requireProjectPermission({ actorId, projectId, permission, dbExecutor, }: RequireProjectPermissionInput): Promise<void>;
+}

package/dist/packages/core/src/agent-sessions/project-runtime-session/application/ai-container-launcher.d.ts

@@ -0,0 +1,21 @@
+import type { UuidV7 } from "@boboddy/core/common/contracts/uuid-v7";
+import type { AnyJsonObject } from "@boboddy/core/common/contracts/json";
+export type LaunchAiContainerInput = {
+    sessionId: UuidV7;
+    projectId: UuidV7;
+    requestedByUserId: UuidV7;
+    workspacePath: string;
+    extraEnv?: Record<string, string> | undefined;
+    additionalNetworks?: string[] | undefined;
+};
+export type LaunchAiContainerResult = {
+    containerId: string;
+    baseUrl: string;
+    image: string;
+    opencodeLogDirectory: string;
+    metadata?: AnyJsonObject | undefined;
+};
+export type AiContainerLauncher = {
+    launch(input: LaunchAiContainerInput): Promise<LaunchAiContainerResult>;
+    stop(containerId: string): Promise<void>;
+};

package/dist/packages/core/src/agent-sessions/project-runtime-session/application/create-project-runtime-session.d.ts

@@ -0,0 +1,13 @@
+import type { DbExecutor } from "@boboddy/core/lib/db/db-executor";
+import type { TimeProvider } from "@boboddy/core/lib/time-provider";
+import type { UuidV7 } from "@boboddy/core/common/contracts/uuid-v7";
+import type { ProjectRepo } from "@boboddy/core/projects/project/application/project-repo";
+import type { ProjectRuntimeSessionRepo } from "./project-runtime-session-repo";
+import { type CreateProjectRuntimeSessionInput, type ProjectRuntimeSessionContract } from "../contracts/project-runtime-session-contracts";
+export declare const createProjectRuntimeSession: (input: CreateProjectRuntimeSessionInput, { userId, projectRepo, projectRuntimeSessionRepo, timeProvider, dbExecutor, }: {
+    userId: UuidV7;
+    projectRepo: ProjectRepo;
+    projectRuntimeSessionRepo: ProjectRuntimeSessionRepo;
+    timeProvider: TimeProvider;
+    dbExecutor?: DbExecutor | undefined;
+}) => Promise<ProjectRuntimeSessionContract>;

package/dist/packages/core/src/agent-sessions/project-runtime-session/application/devcontainer-launcher.d.ts

@@ -0,0 +1,21 @@
+import type { UuidV7 } from "@boboddy/core/common/contracts/uuid-v7";
+import type { AnyJsonObject } from "@boboddy/core/common/contracts/json";
+export type ResolveDevcontainerConfigInput = {
+    workspacePath: string;
+};
+export type LaunchDevcontainerInput = {
+    sessionId: UuidV7;
+    projectId: UuidV7;
+    requestedByUserId: UuidV7;
+    workspacePath: string;
+    devcontainerConfigPath: string;
+};
+export type LaunchDevcontainerResult = {
+    containerId: string;
+    metadata?: AnyJsonObject | undefined;
+};
+export type DevcontainerLauncher = {
+    resolveConfigPath(input: ResolveDevcontainerConfigInput): Promise<string>;
+    launch(input: LaunchDevcontainerInput): Promise<LaunchDevcontainerResult>;
+    stop(containerId: string): Promise<void>;
+};

package/dist/packages/core/src/agent-sessions/project-runtime-session/application/get-project-runtime-session.d.ts

@@ -0,0 +1,11 @@
+import type { DbExecutor } from "@boboddy/core/lib/db/db-executor";
+import type { UuidV7 } from "@boboddy/core/common/contracts/uuid-v7";
+import type { ProjectRepo } from "@boboddy/core/projects/project/application/project-repo";
+import type { ProjectRuntimeSessionRepo } from "./project-runtime-session-repo";
+import { type GetProjectRuntimeSessionInput, type ProjectRuntimeSessionContract } from "../contracts/project-runtime-session-contracts";
+export declare const getProjectRuntimeSession: (input: GetProjectRuntimeSessionInput, { userId, projectRepo, projectRuntimeSessionRepo, dbExecutor, }: {
+    userId: UuidV7;
+    projectRepo: ProjectRepo;
+    projectRuntimeSessionRepo: ProjectRuntimeSessionRepo;
+    dbExecutor?: DbExecutor | undefined;
+}) => Promise<ProjectRuntimeSessionContract>;

package/dist/packages/core/src/agent-sessions/project-runtime-session/application/git-clone-service.d.ts

@@ -0,0 +1,11 @@
+export type CloneRepositoryInput = {
+    gitUrl: string;
+    workspacePath: string;
+    requestedBranch?: string | null | undefined;
+};
+export type CloneRepositoryResult = {
+    resolvedBranch: string;
+};
+export type GitCloneService = {
+    cloneRepository(input: CloneRepositoryInput): Promise<CloneRepositoryResult>;
+};

package/dist/packages/core/src/agent-sessions/project-runtime-session/application/list-project-runtime-sessions.d.ts

@@ -0,0 +1,11 @@
+import type { DbExecutor } from "@boboddy/core/lib/db/db-executor";
+import type { UuidV7 } from "@boboddy/core/common/contracts/uuid-v7";
+import type { ProjectRepo } from "@boboddy/core/projects/project/application/project-repo";
+import type { ProjectRuntimeSessionRepo } from "./project-runtime-session-repo";
+import { type ListProjectRuntimeSessionsInput, type ProjectRuntimeSessionContract } from "../contracts/project-runtime-session-contracts";
+export declare const listProjectRuntimeSessions: (input: ListProjectRuntimeSessionsInput, { userId, projectRepo, projectRuntimeSessionRepo, dbExecutor, }: {
+    userId: UuidV7;
+    projectRepo: ProjectRepo;
+    projectRuntimeSessionRepo: ProjectRuntimeSessionRepo;
+    dbExecutor?: DbExecutor | undefined;
+}) => Promise<ProjectRuntimeSessionContract[]>;

package/dist/packages/core/src/agent-sessions/project-runtime-session/application/project-runtime-session-contract-mapper.d.ts

@@ -0,0 +1,3 @@
+import { type ProjectRuntimeSessionContract } from "../contracts/project-runtime-session-contracts";
+import type { ProjectRuntimeSessionEntity } from "../domain/project-runtime-session-entity";
+export declare const projectRuntimeSessionEntityToContract: (session: ProjectRuntimeSessionEntity) => ProjectRuntimeSessionContract;

package/dist/packages/core/src/agent-sessions/project-runtime-session/application/project-runtime-session-execution-target.d.ts

@@ -0,0 +1,3 @@
+import type { ProjectRuntimeSessionExecutionEnvironment, ProjectRuntimeSessionExecutionTarget } from "../domain/project-runtime-session-execution-target";
+import type { ProjectRuntimeSessionEntity } from "../domain/project-runtime-session-entity";
+export declare const getProjectRuntimeSessionExecutionTarget: (session: ProjectRuntimeSessionEntity, environmentRole: ProjectRuntimeSessionExecutionEnvironment) => ProjectRuntimeSessionExecutionTarget;

package/dist/packages/core/src/agent-sessions/project-runtime-session/application/project-runtime-session-network-metadata.d.ts

@@ -0,0 +1,15 @@
+import type { AnyJsonObject } from "@boboddy/core/common/contracts/json";
+export declare const PROJECT_RUNTIME_SESSION_PROJECT_NETWORK_ALIAS = "devcontainer";
+export declare const PROJECT_RUNTIME_SESSION_AGENT_NETWORK_ALIAS = "agent";
+export type ProjectRuntimeSessionNetworkMetadata = {
+    name: string;
+    aliases: {
+        project: string;
+        agent?: string | undefined;
+    };
+};
+export declare const getProjectRuntimeSessionNetworkMetadata: (metadata: AnyJsonObject) => ProjectRuntimeSessionNetworkMetadata | null;
+export declare const setProjectRuntimeSessionNetworkMetadata: ({ metadata, network, }: {
+    metadata: AnyJsonObject;
+    network: ProjectRuntimeSessionNetworkMetadata;
+}) => AnyJsonObject;

package/dist/packages/core/src/agent-sessions/project-runtime-session/application/project-runtime-session-repo.d.ts

@@ -0,0 +1,10 @@
+import type { UuidV7 } from "@boboddy/core/common/contracts/uuid-v7";
+import type { DbExecutor } from "@boboddy/core/lib/db/db-executor";
+import type { ProjectRuntimeSessionEntity } from "../domain/project-runtime-session-entity";
+export type ProjectRuntimeSessionRepo = {
+    load(id: UuidV7, dbExecutor?: DbExecutor): Promise<ProjectRuntimeSessionEntity | null>;
+    listByProjectId(projectId: UuidV7, dbExecutor?: DbExecutor): Promise<ProjectRuntimeSessionEntity[]>;
+    loadQueued(limit: number, dbExecutor?: DbExecutor): Promise<ProjectRuntimeSessionEntity[]>;
+    create(session: ProjectRuntimeSessionEntity, dbExecutor?: DbExecutor): Promise<ProjectRuntimeSessionEntity>;
+    save(session: ProjectRuntimeSessionEntity, dbExecutor?: DbExecutor): Promise<ProjectRuntimeSessionEntity>;
+};

package/dist/packages/core/src/agent-sessions/project-runtime-session/application/runtime-session-network-manager.d.ts

@@ -0,0 +1,14 @@
+import type { UuidV7 } from "@boboddy/core/common/contracts/uuid-v7";
+export type CreateRuntimeSessionNetworkResult = {
+    networkName: string;
+};
+export type AttachRuntimeSessionContainerInput = {
+    networkName: string;
+    containerId: string;
+    alias?: string | undefined;
+};
+export type RuntimeSessionNetworkManager = {
+    createNetwork(sessionId: UuidV7): Promise<CreateRuntimeSessionNetworkResult>;
+    attachContainer(input: AttachRuntimeSessionContainerInput): Promise<void>;
+    removeNetwork(networkName: string): Promise<void>;
+};