@figulus/schema 0.4.0-alpha-dev → 0.5.0-alpha-dev-2

package/dist/engine/paths/containers.d.ts

@@ -0,0 +1,8 @@
+import { RouteConfig } from "@asteasolutions/zod-to-openapi";
+export declare const runContainerRouteSchema: RouteConfig;
+export declare const getContainerStatusRouteSchema: RouteConfig;
+export declare const cancelContainerRouteSchema: RouteConfig;
+export declare const cleanupContainerRouteSchema: RouteConfig;
+export declare const cleanupOrphanedContainersRouteSchema: RouteConfig;
+export declare const extractArtifactsRouteSchema: RouteConfig;
+//# sourceMappingURL=containers.d.ts.map

package/dist/engine/paths/containers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"containers.d.ts","sourceRoot":"","sources":["../../../src/engine/paths/containers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAS7D,eAAO,MAAM,uBAAuB,EAAE,WAoDrC,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,WA+C3C,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,WAsDxC,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,WAsDzC,CAAC;AAEF,eAAO,MAAM,oCAAoC,EAAE,WA+BlD,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,WA8CzC,CAAC"}

package/dist/engine/paths/containers.js

@@ -0,0 +1,297 @@
+import { extractArtifactsRequestSchema, extractArtifactsResponseSchema } from "../images.js";
+import z from "zod";
+import { extendZodWithOpenApi } from "@asteasolutions/zod-to-openapi";
+import { runRequestSchema, runResponseSchema } from "../deprecated/run-request.js";
+import { errorResponseSchema } from "../response.js";
+extendZodWithOpenApi(z);
+export const runContainerRouteSchema = {
+    method: "post",
+    path: "/api/v1/containers/run",
+    operationId: "runContainer",
+    summary: "Run a container job (removed — returns 410)",
+    description: "**Removed in v0.2.0.** This endpoint always returns 410 Gone. Use POST /api/v1/sessions with config.auto_cleanup: true and block_until_complete: true instead.",
+    tags: [
+        "containers"
+    ],
+    deprecated: true,
+    request: {
+        body: {
+            description: undefined,
+            content: {
+                "application/json": {
+                    schema: runRequestSchema
+                }
+            },
+            required: true
+        }
+    },
+    responses: {
+        202: {
+            description: "Job accepted and queued",
+            content: {
+                "application/json": {
+                    schema: runResponseSchema,
+                    example: {
+                        job_id: "job-abc123",
+                        status: "pending",
+                        message: "Job accepted and queued"
+                    }
+                }
+            }
+        },
+        400: {
+            description: "Invalid request body or validation failure",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        },
+        500: {
+            description: "Failed to start job",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        }
+    }
+};
+export const getContainerStatusRouteSchema = {
+    method: "get",
+    path: "/api/v1/containers/{job_id}",
+    operationId: "getContainerStatus",
+    summary: "Get job status",
+    description: "Returns the current status and output of a container job.",
+    tags: [
+        "containers"
+    ],
+    parameters: [
+        {
+            name: "job_id",
+            in: "path",
+            required: true,
+            schema: {
+                type: "string"
+            },
+            example: "job-abc123"
+        }
+    ],
+    deprecated: true,
+    responses: {
+        200: {
+            description: "Job found",
+            content: {
+                "application/json": {
+                    schema: runResponseSchema
+                }
+            }
+        },
+        400: {
+            description: "Missing job_id",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        },
+        404: {
+            description: "Job not found",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        }
+    }
+};
+export const cancelContainerRouteSchema = {
+    method: "delete",
+    path: "/api/v1/containers/{job_id}",
+    operationId: "cancelContainer",
+    summary: "Cancel a running job",
+    description: "Cancels an in-progress container job. No-ops if already completed.",
+    tags: [
+        "containers"
+    ],
+    parameters: [
+        {
+            name: "job_id",
+            in: "path",
+            required: true,
+            schema: {
+                type: "string"
+            },
+            example: "job-abc123"
+        }
+    ],
+    deprecated: true,
+    responses: {
+        200: {
+            description: "Job cancelled",
+            content: {
+                "application/json": {
+                    schema: z.object({
+                        job_id: z.string(),
+                        message: z.string(),
+                    }),
+                    example: {
+                        job_id: "job-abc123",
+                        message: "Job cancelled successfully"
+                    }
+                }
+            }
+        },
+        400: {
+            description: "Missing job_id",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        },
+        500: {
+            description: "Cancel failed",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        }
+    }
+};
+export const cleanupContainerRouteSchema = {
+    method: "post",
+    path: "/api/v1/containers/{job_id}/cleanup",
+    operationId: "cleanupContainer",
+    summary: "Clean up a specific container",
+    description: "Removes the container associated with a job after artifact extraction.",
+    tags: [
+        "containers"
+    ],
+    parameters: [
+        {
+            name: "job_id",
+            in: "path",
+            required: true,
+            schema: {
+                type: "string"
+            },
+            example: "job-abc123"
+        }
+    ],
+    deprecated: true,
+    responses: {
+        200: {
+            description: "Container cleaned up",
+            content: {
+                "application/json": {
+                    schema: z.object({
+                        job_id: z.string(),
+                        message: z.string(),
+                    }),
+                    example: {
+                        job_id: "job-abc123",
+                        message: "Container cleaned up successfully"
+                    }
+                }
+            }
+        },
+        400: {
+            description: "Missing job_id",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        },
+        500: {
+            description: "Cleanup failed",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        }
+    }
+};
+export const cleanupOrphanedContainersRouteSchema = {
+    method: "post",
+    path: "/api/v1/containers/cleanup",
+    operationId: "cleanupOrphanedContainers",
+    summary: "Clean up all orphaned containers",
+    description: "Removes all Figulus-managed containers that are no longer tracked.",
+    tags: [
+        "containers"
+    ],
+    deprecated: true,
+    responses: {
+        200: {
+            description: "Orphaned containers removed",
+            content: {
+                "application/json": {
+                    schema: z.object({
+                        removed: z.int().describe("Number of containers removed"),
+                        message: z.string(),
+                    }),
+                }
+            }
+        },
+        500: {
+            description: "Cleanup failed",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        }
+    }
+};
+export const extractArtifactsRouteSchema = {
+    method: "post",
+    path: "/api/v1/containers/extract",
+    operationId: "extractArtifacts",
+    summary: "Extract files from a container",
+    description: "Copies files from a container path to a host path.",
+    tags: [
+        "containers"
+    ],
+    request: {
+        body: {
+            description: undefined,
+            content: {
+                "application/json": {
+                    schema: extractArtifactsRequestSchema
+                }
+            },
+            required: true
+        }
+    },
+    responses: {
+        200: {
+            description: "Artifacts extracted",
+            content: {
+                "application/json": {
+                    schema: extractArtifactsResponseSchema
+                }
+            }
+        },
+        400: {
+            description: "Validation failure",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        },
+        500: {
+            description: "Extraction failed (container not found, path not found, etc.)",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        }
+    }
+};
+//# sourceMappingURL=containers.js.map

package/dist/engine/paths/containers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"containers.js","sourceRoot":"","sources":["../../../src/engine/paths/containers.ts"],"names":[],"mappings":"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"}

package/dist/engine/paths/dry-run.d.ts

@@ -0,0 +1,3 @@
+import { RouteConfig } from "@asteasolutions/zod-to-openapi";
+export declare const dryRunContainerRouteSchema: RouteConfig;
+//# sourceMappingURL=dry-run.d.ts.map

package/dist/engine/paths/dry-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dry-run.d.ts","sourceRoot":"","sources":["../../../src/engine/paths/dry-run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAK7D,eAAO,MAAM,0BAA0B,EAAE,WAsCxC,CAAC"}

package/dist/engine/paths/dry-run.js

@@ -0,0 +1,43 @@
+import { runRequestSchema } from "../deprecated/run-request.js";
+import { dryRunResponseSchema } from "../dry-run.js";
+import { errorResponseSchema } from "../response.js";
+export const dryRunContainerRouteSchema = {
+    method: "post",
+    path: "/api/v1/dryRun",
+    operationId: "dryRunContainer",
+    summary: "Dry-run a container command",
+    description: "Returns the resolved final command without executing it. Requires image and command fields; other RunRequest fields are optional.",
+    tags: [
+        "containers"
+    ],
+    request: {
+        body: {
+            description: undefined,
+            content: {
+                "application/json": {
+                    schema: runRequestSchema
+                }
+            },
+            required: true
+        }
+    },
+    responses: {
+        200: {
+            description: "Resolved command",
+            content: {
+                "application/json": {
+                    schema: dryRunResponseSchema
+                }
+            }
+        },
+        400: {
+            description: "Missing image or command",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        }
+    }
+};
+//# sourceMappingURL=dry-run.js.map

package/dist/engine/paths/dry-run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dry-run.js","sourceRoot":"","sources":["../../../src/engine/paths/dry-run.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,CAAC,MAAM,0BAA0B,GAAgB;IACrD,MAAM,EAAE,MAAM;IACd,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,iBAAiB;IAC9B,OAAO,EAAE,6BAA6B;IACtC,WAAW,EAAE,mIAAmI;IAChJ,IAAI,EAAE;QACJ,YAAY;KACb;IACD,OAAO,EAAE;QACP,IAAI,EAAE;YACJ,WAAW,EAAE,SAAS;YACtB,OAAO,EAAE;gBACP,kBAAkB,EAAE;oBAClB,MAAM,EAAE,gBAAgB;iBACzB;aACF;YACD,QAAQ,EAAE,IAAI;SACf;KACF;IACD,SAAS,EAAE;QACT,GAAG,EAAE;YACH,WAAW,EAAE,kBAAkB;YAC/B,OAAO,EAAE;gBACP,kBAAkB,EAAE;oBAClB,MAAM,EAAE,oBAAoB;iBAC7B;aACF;SACF;QACD,GAAG,EAAE;YACH,WAAW,EAAE,0BAA0B;YACvC,OAAO,EAAE;gBACP,kBAAkB,EAAE;oBAClB,MAAM,EAAE,mBAAmB;iBAC5B;aACF;SACF;KACF;CACF,CAAC"}

package/dist/engine/paths/health.d.ts

@@ -0,0 +1,3 @@
+import { RouteConfig } from "@asteasolutions/zod-to-openapi";
+export declare const healthRouteSchema: RouteConfig;
+//# sourceMappingURL=health.d.ts.map

package/dist/engine/paths/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../../src/engine/paths/health.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAG7D,eAAO,MAAM,iBAAiB,EAAE,WAiC/B,CAAA"}

package/dist/engine/paths/health.js

@@ -0,0 +1,36 @@
+import { healthResponseSchema } from "../health.js";
+export const healthRouteSchema = {
+    method: "get",
+    path: "/health",
+    operationId: "getHealth",
+    summary: "Engine health check",
+    description: "Returns engine health and Docker connectivity status. Returns 503 if the Docker daemon is unreachable.",
+    tags: ["health"],
+    responses: {
+        200: {
+            description: "Engine is healthy",
+            content: {
+                "application/json": {
+                    schema: healthResponseSchema,
+                    example: {
+                        status: "healthy",
+                        docker_api: "1.47",
+                    },
+                },
+            },
+        },
+        503: {
+            description: "Docker daemon unreachable",
+            content: {
+                "application/json": {
+                    schema: healthResponseSchema,
+                    example: {
+                        status: "unhealthy",
+                        message: "Docker daemon unreachable: connection refused"
+                    }
+                }
+            }
+        }
+    }
+};
+//# sourceMappingURL=health.js.map

package/dist/engine/paths/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../../src/engine/paths/health.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,CAAC,MAAM,iBAAiB,GAAgB;IAC1C,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,WAAW;IACxB,OAAO,EAAE,qBAAqB;IAC9B,WAAW,EAAE,wGAAwG;IACrH,IAAI,EAAE,CAAC,QAAQ,CAAC;IAChB,SAAS,EAAE;QACP,GAAG,EAAE;YACD,WAAW,EAAE,mBAAmB;YAChC,OAAO,EAAE;gBACL,kBAAkB,EAAE;oBAChB,MAAM,EAAE,oBAAoB;oBAC5B,OAAO,EAAE;wBACL,MAAM,EAAE,SAAS;wBACjB,UAAU,EAAE,MAAM;qBACrB;iBACJ;aACJ;SACJ;QACD,GAAG,EAAE;YACD,WAAW,EAAE,2BAA2B;YACxC,OAAO,EAAE;gBACL,kBAAkB,EAAE;oBAChB,MAAM,EAAE,oBAAoB;oBAC5B,OAAO,EAAE;wBACL,MAAM,EAAE,WAAW;wBACnB,OAAO,EAAE,+CAA+C;qBAC3D;iBACJ;aACJ;SACJ;KACJ;CACJ,CAAA"}

package/dist/engine/paths/images.d.ts

@@ -0,0 +1,5 @@
+import { RouteConfig } from "@asteasolutions/zod-to-openapi";
+export declare const buildImageRouteSchema: RouteConfig;
+export declare const pruneImagesRouteSchema: RouteConfig;
+export declare const pruneCacheRouteSchema: RouteConfig;
+//# sourceMappingURL=images.d.ts.map

package/dist/engine/paths/images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.d.ts","sourceRoot":"","sources":["../../../src/engine/paths/images.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAS7D,eAAO,MAAM,qBAAqB,EAAE,WA8CnC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,WA2DpC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,WA6BnC,CAAC"}

package/dist/engine/paths/images.js

@@ -0,0 +1,144 @@
+import z from "zod";
+import { buildImageRequestSchema, buildImageResponseSchema, pruneImagesRequestSchema, pruneImagesResponseSchema } from "../images.js";
+import { bigIntSchema } from "../../core/primitives.js";
+import { extendZodWithOpenApi } from "@asteasolutions/zod-to-openapi";
+import { errorResponseSchema } from "../response.js";
+extendZodWithOpenApi(z);
+export const buildImageRouteSchema = {
+    method: "post",
+    path: "/api/v1/images/build",
+    operationId: "buildImage",
+    summary: "Build a Docker image from a RunnerParts spec",
+    description: "Content-addressable image build. Returns immediately with a cache hit if the spec hash matches an existing image; otherwise builds and pushes.",
+    tags: [
+        "images"
+    ],
+    request: {
+        body: {
+            description: undefined,
+            content: {
+                "application/json": {
+                    schema: buildImageRequestSchema
+                }
+            },
+            required: true
+        }
+    },
+    responses: {
+        200: {
+            description: "Image built or found in cache",
+            content: {
+                "application/json": {
+                    schema: buildImageResponseSchema
+                }
+            }
+        },
+        400: {
+            description: "Invalid spec or request",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        },
+        500: {
+            description: "Build or push failed",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        }
+    }
+};
+export const pruneImagesRouteSchema = {
+    method: "post",
+    path: "/api/v1/images/prune",
+    operationId: "pruneImages",
+    summary: "Garbage-collect unused Figulus images",
+    description: "Removes images that have not been used within the retention window. When `all` is true, also prunes all unused Docker images (equivalent to `docker image prune -a`).",
+    tags: [
+        "images"
+    ],
+    parameters: [
+        {
+            name: "retention_days",
+            in: "query",
+            required: false,
+            schema: {
+                type: "integer",
+                minimum: 1,
+                default: 30
+            },
+            description: "Images unused for longer than this many days are removed"
+        }
+    ],
+    request: {
+        body: {
+            description: undefined,
+            content: {
+                "application/json": {
+                    schema: pruneImagesRequestSchema
+                }
+            },
+            required: false
+        }
+    },
+    responses: {
+        200: {
+            description: "GC completed",
+            content: {
+                "application/json": {
+                    schema: pruneImagesResponseSchema
+                }
+            }
+        },
+        400: {
+            description: "Invalid retention_days value",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        },
+        500: {
+            description: "GC failed",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        }
+    }
+};
+export const pruneCacheRouteSchema = {
+    method: "post",
+    path: "/api/v1/images/prune-cache",
+    operationId: "pruneCache",
+    summary: "Prune Docker build cache",
+    description: "Removes all unused Docker build cache entries. Equivalent to `docker buildx prune -a`.",
+    tags: [
+        "images"
+    ],
+    responses: {
+        200: {
+            description: "Build cache pruned",
+            content: {
+                "application/json": {
+                    schema: z.object({
+                        freed_bytes: bigIntSchema.describe("Bytes freed from build cache")
+                    })
+                }
+            }
+        },
+        500: {
+            description: "Prune failed",
+            content: {
+                "application/json": {
+                    schema: errorResponseSchema
+                }
+            }
+        }
+    }
+};
+//# sourceMappingURL=images.js.map

package/dist/engine/paths/images.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.js","sourceRoot":"","sources":["../../../src/engine/paths/images.ts"],"names":[],"mappings":"AACA,OAAO,CAAC,MAAM,KAAK,CAAC;AACpB,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACtI,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAErD,oBAAoB,CAAC,CAAC,CAAC,CAAC;AAExB,MAAM,CAAC,MAAM,qBAAqB,GAAgB;IAChD,MAAM,EAAE,MAAM;IACd,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE,YAAY;IACzB,OAAO,EAAE,8CAA8C;IACvD,WAAW,EAAE,gJAAgJ;IAC7J,IAAI,EAAE;QACJ,QAAQ;KACT;IACD,OAAO,EAAE;QACP,IAAI,EAAE;YACJ,WAAW,EAAE,SAAS;YACtB,OAAO,EAAE;gBACP,kBAAkB,EAAE;oBAClB,MAAM,EAAE,uBAAuB;iBAChC;aACF;YACD,QAAQ,EAAE,IAAI;SACf;KACF;IACD,SAAS,EAAE;QACT,GAAG,EAAE;YACH,WAAW,EAAE,+BAA+B;YAC5C,OAAO,EAAE;gBACP,kBAAkB,EAAE;oBAClB,MAAM,EAAE,wBAAwB;iBACjC;aACF;SACF;QACD,GAAG,EAAE;YACH,WAAW,EAAE,yBAAyB;YACtC,OAAO,EAAE;gBACP,kBAAkB,EAAE;oBAClB,MAAM,EAAE,mBAAmB;iBAC5B;aACF;SACF;QACD,GAAG,EAAE;YACH,WAAW,EAAE,sBAAsB;YACnC,OAAO,EAAE;gBACP,kBAAkB,EAAE;oBAClB,MAAM,EAAE,mBAAmB;iBAC5B;aACF;SACF;KACF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAgB;IACjD,MAAM,EAAE,MAAM;IACd,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE,aAAa;IAC1B,OAAO,EAAE,uCAAuC;IAChD,WAAW,EAAE,uKAAuK;IACpL,IAAI,EAAE;QACJ,QAAQ;KACT;IACD,UAAU,EAAE;QACV;YACE,IAAI,EAAE,gBAAgB;YACtB,EAAE,EAAE,OAAO;YACX,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE;gBACN,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,EAAE;aACZ;YACD,WAAW,EAAE,0DAA0D;SACxE;KACF;IACD,OAAO,EAAE;QACP,IAAI,EAAE;YACJ,WAAW,EAAE,SAAS;YACtB,OAAO,EAAE;gBACP,kBAAkB,EAAE;oBAClB,MAAM,EAAE,wBAAwB;iBACjC;aACF;YACD,QAAQ,EAAE,KAAK;SAChB;KACF;IACD,SAAS,EAAE;QACT,GAAG,EAAE;YACH,WAAW,EAAE,cAAc;YAC3B,OAAO,EAAE;gBACP,kBAAkB,EAAE;oBAClB,MAAM,EAAE,yBAAyB;iBAClC;aACF;SACF;QACD,GAAG,EAAE;YACH,WAAW,EAAE,8BAA8B;YAC3C,OAAO,EAAE;gBACP,kBAAkB,EAAE;oBAClB,MAAM,EAAE,mBAAmB;iBAC5B;aACF;SACF;QACD,GAAG,EAAE;YACH,WAAW,EAAE,WAAW;YACxB,OAAO,EAAE;gBACP,kBAAkB,EAAE;oBAClB,MAAM,EAAE,mBAAmB;iBAC5B;aACF;SACF;KACF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAgB;IAChD,MAAM,EAAE,MAAM;IACd,IAAI,EAAE,4BAA4B;IAClC,WAAW,EAAE,YAAY;IACzB,OAAO,EAAE,0BAA0B;IACnC,WAAW,EAAE,wFAAwF;IACrG,IAAI,EAAE;QACJ,QAAQ;KACT;IACD,SAAS,EAAE;QACT,GAAG,EAAE;YACH,WAAW,EAAE,oBAAoB;YACjC,OAAO,EAAE;gBACP,kBAAkB,EAAE;oBAClB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;wBACf,WAAW,EAAE,YAAY,CAAC,QAAQ,CAAC,8BAA8B,CAAC;qBACnE,CAAC;iBACH;aACF;SACF;QACD,GAAG,EAAE;YACH,WAAW,EAAE,cAAc;YAC3B,OAAO,EAAE;gBACP,kBAAkB,EAAE;oBAClB,MAAM,EAAE,mBAAmB;iBAC5B;aACF;SACF;KACF;CACF,CAAC"}

package/dist/engine/paths/index.d.ts

@@ -0,0 +1,8 @@
+export * from './containers.js';
+export * from './dry-run.js';
+export * from './health.js';
+export * from './images.js';
+export * from './sessions.js';
+export * from './stacks.js';
+export * from './volumes.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/paths/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/paths/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}

package/dist/engine/paths/index.js

@@ -0,0 +1,8 @@
+export * from './containers.js';
+export * from './dry-run.js';
+export * from './health.js';
+export * from './images.js';
+export * from './sessions.js';
+export * from './stacks.js';
+export * from './volumes.js';
+//# sourceMappingURL=index.js.map

package/dist/engine/paths/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/paths/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}

package/dist/engine/paths/sessions.d.ts

@@ -0,0 +1,10 @@
+import { RouteConfig } from "@asteasolutions/zod-to-openapi";
+export declare const listSessionsRouteSchema: RouteConfig;
+export declare const createSessionRouteSchema: RouteConfig;
+export declare const getSessionRouteSchema: RouteConfig;
+export declare const deleteSessionRouteSchema: RouteConfig;
+export declare const runInSessionRouteSchema: RouteConfig;
+export declare const syncFileInSessionRouteSchema: RouteConfig;
+export declare const listSessionRunsRouteSchema: RouteConfig;
+export declare const getSessionRunRouteSchema: RouteConfig;
+//# sourceMappingURL=sessions.d.ts.map

package/dist/engine/paths/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../../src/engine/paths/sessions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAQ7D,eAAO,MAAM,uBAAuB,EAAE,WA8BrC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,WAsDtC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,WAsDnC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,WA6DtC,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,WAyErC,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,WAiF1C,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,WAsDxC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,WA+DtC,CAAC"}