@blaxel/core 0.3.26-preview.311 → 0.3.26-preview.313

package/dist/cjs/types/sandbox/client/types.gen.d.ts

@@ -51,6 +51,9 @@ export type ArchiveManifest = {
 };
 export type ContentSearchMatch = {
     column: number;
+    /**
+     * The matching line with up to contextLines lines before and after it, newline-separated; omitted when contextLines is 0
+     */
     context?: string;
     line: number;
     path: string;
@@ -278,11 +281,17 @@ export type FuzzySearchResponse = {
 };
 export type HealthResponse = {
     arch: string;
+    /**
+     * Build time in RFC 3339 (UTC), or "unknown" for builds without it
+     */
     buildTime: string;
     gitCommit: string;
     goVersion: string;
     lastUpgrade: UpgradeStatus;
     os: string;
+    /**
+     * API start time in RFC 3339
+     */
     startedAt: string;
     status: string;
     upgradeCount: number;
@@ -344,6 +353,9 @@ export type PortMonitorRequest = {
     callback?: string;
 };
 export type ProcessLogs = {
+    /**
+     * Concatenation of the returned stdout followed by the returned stderr. Output from the two streams is not interleaved.
+     */
     logs: string;
     stderr: string;
     stdout: string;
@@ -377,6 +389,9 @@ export type ProcessRequest = {
 };
 export type ProcessResponse = {
     command: string;
+    /**
+     * Completion time, same format as startedAt. Empty string while the process runs
+     */
     completedAt: string;
     exitCode: number;
     /**
@@ -389,6 +404,9 @@ export type ProcessResponse = {
     pid: string;
     restartCount?: number;
     restartOnFailure?: boolean;
+    /**
+     * Start time as an HTTP date (RFC 1123, e.g. Wed, 01 Jan 2023 12:00:00 GMT)
+     */
     startedAt: string;
     status: 'failed' | 'killed' | 'stopped' | 'running' | 'completed';
     stderr: string;
@@ -578,7 +596,7 @@ export type PostArchiveExportErrors = {
      */
     400: ErrorResponse;
     /**
-     * An export is already in progress
+     * An export is already in progress, or the sandbox is frozen for a restore
      */
     409: ErrorResponse;
     /**
@@ -858,6 +876,10 @@ export type GetFilesystemContentSearchByPathData = {
          * Comma-separated directory names to skip (default: node_modules,vendor,.git,dist,build,target,__pycache__,.venv,.next,coverage)
          */
         excludeDirs?: string;
+        /**
+         * Lines to include before and after each match in its context field (default: 0, max: 20; invalid values count as 0)
+         */
+        contextLines?: number;
     };
     url: '/filesystem-content-search/{path}';
 };
@@ -1143,12 +1165,16 @@ export type GetFilesystemSearchByPathData = {
         path: string;
     };
     query?: {
+        /**
+         * Fuzzy pattern matched against each relative path (e.g., mngo for src/main.go). When omitted, the search path itself is used as the pattern.
+         */
+        query?: string;
         /**
          * Maximum number of results to return (default: 20)
          */
         maxResults?: number;
         /**
-         * Comma-separated file patterns to include (e.g., *.go,*.js)
+         * Accepted for compatibility but currently ignored; use filesystem-find for glob filtering
          */
         patterns?: string;
         /**
@@ -1226,7 +1252,7 @@ export type GetFilesystemByPathData = {
     body?: never;
     path: {
         /**
-         * File or directory path
+         * File or directory path. Relative paths are resolved against the filesystem working directory. For example, with a working directory of /app, GET /filesystem/workspace resolves to /app/workspace. To access the absolute path /workspace over HTTP, encode its leading slash as %2F: GET /filesystem/%2Fworkspace. The double-slash form GET /filesystem//workspace also addresses /workspace.
          */
         path: string;
     };
@@ -1260,6 +1286,23 @@ export type GetFilesystemByPathResponses = {
     200: Directory | FileWithContent | (Blob | File);
 };
 export type GetFilesystemByPathResponse = GetFilesystemByPathResponses[keyof GetFilesystemByPathResponses];
+export type HeadFilesystemByPathData = {
+    body?: never;
+    path: {
+        /**
+         * File or directory path
+         */
+        path: string;
+    };
+    query?: never;
+    url: '/filesystem/{path}';
+};
+export type HeadFilesystemByPathResponses = {
+    /**
+     * Path metadata (X-File-Type is set only when stat succeeds)
+     */
+    200: unknown;
+};
 export type PutFilesystemByPathData = {
     /**
      * File or directory details
@@ -1364,7 +1407,7 @@ export type GetFilesystemTreeByPathResponses = {
     /**
      * Directory tree
      */
-    200: Directory | FileWithContent | (Blob | File);
+    200: Directory;
 };
 export type GetFilesystemTreeByPathResponse = GetFilesystemTreeByPathResponses[keyof GetFilesystemTreeByPathResponses];
 export type PutFilesystemTreeByPathData = {
@@ -1400,7 +1443,7 @@ export type PutFilesystemTreeByPathResponses = {
     /**
      * Updated directory tree
      */
-    200: Directory | FileWithContent | (Blob | File);
+    200: Directory;
 };
 export type PutFilesystemTreeByPathResponse = PutFilesystemTreeByPathResponses[keyof PutFilesystemTreeByPathResponses];
 export type GetHealthData = {
@@ -1651,7 +1694,7 @@ export type DeleteProcessByIdentifierErrors = {
 export type DeleteProcessByIdentifierError = DeleteProcessByIdentifierErrors[keyof DeleteProcessByIdentifierErrors];
 export type DeleteProcessByIdentifierResponses = {
     /**
-     * Process stopped
+     * Process stop requested
      */
     200: SuccessResponse;
 };
@@ -1709,7 +1752,7 @@ export type DeleteProcessByIdentifierKillErrors = {
 export type DeleteProcessByIdentifierKillError = DeleteProcessByIdentifierKillErrors[keyof DeleteProcessByIdentifierKillErrors];
 export type DeleteProcessByIdentifierKillResponses = {
     /**
-     * Process killed
+     * Process kill requested
      */
     200: SuccessResponse;
 };
@@ -1749,6 +1792,12 @@ export type GetProcessByIdentifierLogsResponses = {
 export type GetProcessByIdentifierLogsResponse = GetProcessByIdentifierLogsResponses[keyof GetProcessByIdentifierLogsResponses];
 export type GetProcessByIdentifierLogsStreamData = {
     body?: never;
+    headers?: {
+        /**
+         * Explicit application/x-ndjson opts into structured records; absent or wildcard Accept retains text/plain. Supported explicit media types honor q weights, preferring NDJSON on a tie.
+         */
+        Accept?: string;
+    };
     path: {
         /**
          * Process identifier (PID or name)
@@ -1759,14 +1808,18 @@ export type GetProcessByIdentifierLogsStreamData = {
     url: '/process/{identifier}/logs/stream';
 };
 export type GetProcessByIdentifierLogsStreamErrors = {
+    /**
+     * Invalid process identifier
+     */
+    400: ErrorResponse;
     /**
      * Process not found
      */
     404: ErrorResponse;
     /**
-     * Unprocessable entity
+     * Structured history unavailable for this older process
      */
-    422: ErrorResponse;
+    409: ErrorResponse;
     /**
      * Internal server error
      */
@@ -1775,7 +1828,7 @@ export type GetProcessByIdentifierLogsStreamErrors = {
 export type GetProcessByIdentifierLogsStreamError = GetProcessByIdentifierLogsStreamErrors[keyof GetProcessByIdentifierLogsStreamErrors];
 export type GetProcessByIdentifierLogsStreamResponses = {
     /**
-     * Stream of process logs, one line per log (prefixed with stdout:/stderr:)
+     * Process output as prefixed text or NDJSON records
      */
     200: string;
 };
@@ -1880,13 +1933,13 @@ export type GetWatchFilesystemByPathData = {
     body?: never;
     path: {
         /**
-         * Directory path to watch
+         * Directory path to watch (append ** to watch subdirectories)
          */
         path: string;
     };
     query?: {
         /**
-         * Ignore patterns (comma-separated)
+         * Comma-separated substrings; events whose full path contains one are skipped
          */
         ignore?: string;
     };
@@ -1905,7 +1958,7 @@ export type GetWatchFilesystemByPathErrors = {
 export type GetWatchFilesystemByPathError = GetWatchFilesystemByPathErrors[keyof GetWatchFilesystemByPathErrors];
 export type GetWatchFilesystemByPathResponses = {
     /**
-     * Stream of modified file paths, one per line
+     * JSON lines stream of change events
      */
     200: string;
 };