Azure Container Apps session data plane

specification/app/Microsoft.App.DynamicSessions/client.tsp

@@ -0,0 +1,5 @@
+/**
+ * PLACEHOLDER
+ * Add readme and sample
+ */
+import "./main.tsp";

specification/app/Microsoft.App.DynamicSessions/examples/2024-09-01/CodeExecution_ExecuteCode_Result.json

@@ -0,0 +1,48 @@
+{
+  "title": "CodeExecution_ExecuteCode_Result",
+  "operationId": "CodeExecution_ExecuteCode",
+  "parameters": {
+    "api-version": "2024-09-01",
+    "identifier": "testidentidier",
+    "codeExecutionRequest": {
+      "codeInputType": "Inline",
+      "executionType": "Synchronous",
+      "code": "print(7*9)",
+      "timeoutInSeconds": 60
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "codeInputType": "Inline",
+        "executionType": "Synchronous",
+        "code": "print(7*9)",
+        "timeoutInSeconds": 60,
+        "id": "1",
+        "status": "Success",
+        "stdout": "63/n",
+        "stderr": "",
+        "result": "",
+        "executionTimeInMilliseconds": 4
+      }
+    },
+    "202": {
+      "headers": {
+        "Operation_Id": "test-execution-id",
+        "Operation-Location": "location"
+      },
+      "body": {
+        "codeInputType": "Inline",
+        "executionType": "Asynchronous",
+        "code": "7*9",
+        "timeoutInSeconds": 60,
+        "id": "1",
+        "status": "",
+        "stdout": "test-execution-id",
+        "stderr": "",
+        "result": null,
+        "executionTimeInMilliseconds": 0
+      }
+    }
+  }
+}

specification/app/Microsoft.App.DynamicSessions/examples/2024-09-01/CodeExecution_GetResult.json

@@ -0,0 +1,25 @@
+{
+  "title": "CodeExecution_GetResult",
+  "operationId": "CodeExecution_GetResult",
+  "parameters": {
+    "api-version": "2024-09-01",
+    "identifier": "testidentidier",
+    "executionId": "testexecutionid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "codeInputType": "Inline",
+        "executionType": "Asynchronous",
+        "code": "print(7*9)",
+        "timeoutInSeconds": 60,
+        "id": "1",
+        "status": "Success",
+        "stdout": "63/n",
+        "stderr": "",
+        "result": "",
+        "executionTimeInMilliseconds": 4
+      }
+    }
+  }
+}

specification/app/Microsoft.App.DynamicSessions/examples/2024-09-01/SessionResourceFiles_DeleteFile.json

@@ -0,0 +1,12 @@
+{
+  "title": "SessionResourceFiles_DeleteFile",
+  "operationId": "SessionResourceFiles_DeleteFile",
+  "parameters": {
+    "api-version": "2024-09-01",
+    "fileName": "testfile",
+    "identifier": "testidentidier"
+  },
+  "responses": {
+    "204": {}
+  }
+}

specification/app/Microsoft.App.DynamicSessions/examples/2024-09-01/SessionResourceFiles_GetFileContent.json

@@ -0,0 +1,14 @@
+{
+  "title": "SessionResourceFiles_GetFileContent",
+  "operationId": "SessionResourceFiles_GetFileContent",
+  "parameters": {
+    "api-version": "2024-09-01",
+    "fileName": "testfile",
+    "identifier": "testidentidier"
+  },
+  "responses": {
+    "200": {
+      "body": "testfilecontent"
+    }
+  }
+}

specification/app/Microsoft.App.DynamicSessions/examples/2024-09-01/SessionResourceFiles_GetFileMetadata.json

@@ -0,0 +1,19 @@
+{
+  "title": "SessionResourceFiles_GetFileMetadata",
+  "operationId": "SessionResourceFiles_GetFileMetadata",
+  "parameters": {
+    "api-version": "2024-09-01",
+    "fileName": "testfile",
+    "identifier": "testidentidier"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "fileName": "testfile",
+        "sizeInBytes": 4,
+        "createdAt": "2024-05-29T00:00:00.000Z",
+        "lastModifiedAt": "2024-05-29T02:17:25.902Z"
+      }
+    }
+  }
+}

specification/app/Microsoft.App.DynamicSessions/examples/2024-09-01/SessionResourceFiles_ListFilesMetadata.json

@@ -0,0 +1,23 @@
+{
+  "title": "SessionResourceFiles_ListFilesMetadata",
+  "operationId": "SessionResourceFiles_ListFilesMetadata",
+  "parameters": {
+    "api-version": "2024-09-01",
+    "identifier": "testidentidier"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "fileName": "testfile",
+            "sizeInBytes": 4,
+            "createdAt": "2024-05-29T00:00:00.000Z",
+            "lastModifiedAt": "2024-05-29T02:17:25.902Z"
+          }
+        ],
+        "nextLink": null
+      }
+    }
+  }
+}

specification/app/Microsoft.App.DynamicSessions/examples/2024-09-01/SessionResourceFiles_UploadFile.json

@@ -0,0 +1,20 @@
+{
+  "title": "SessionResourceFiles_UploadFile",
+  "operationId": "SessionResourceFiles_UploadFile",
+  "parameters": {
+    "api-version": "2024-09-01",
+    "identifier": "testidentidier",
+    "path": "/",
+    "file": "101010101"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "fileName": "testfile",
+        "sizeInBytes": 4,
+        "createdAt": "2024-05-29T00:00:00.000Z",
+        "lastModifiedAt": "2024-05-29T02:17:25.902Z"
+      }
+    }
+  }
+}

specification/app/Microsoft.App.DynamicSessions/main.tsp

@@ -0,0 +1,31 @@
+import "@typespec/rest";
+import "@typespec/versioning";
+import "@azure-tools/typespec-azure-core";
+import "./routes.tsp";
+
+using TypeSpec.Http;
+using TypeSpec.Rest;
+using TypeSpec.Versioning;
+using Azure.Core;
+
+@useAuth(AadOauth2Auth<["https://dynamicsessions.io/.default"]>)
+@service({
+  title: "Microsoft.App Dynamic Sessions service",
+})
+@server(
+  "{endpoint}",
+  "Session pool management endpoint.",
+  {
+    @doc("The management endpoint of the session pool.")
+    endpoint: string,
+  }
+)
+@versioned(Microsoft.App.DynamicSessions.Versions)
+namespace Microsoft.App.DynamicSessions;
+
+@doc("The Microsoft.App Dynamic Sessions service versions.")
+enum Versions {
+  @useDependency(Azure.Core.Versions.v1_0_Preview_2)
+  @doc("The 2024-09-01 version of the Microsoft.App Dynamic Sessions service.")
+  `2024-09-01`,
+}

specification/app/Microsoft.App.DynamicSessions/models/code-execution-file.tsp

@@ -0,0 +1,30 @@
+import "./common.tsp";
+using TypeSpec.Http;
+using TypeSpec.Rest;
+
+namespace Microsoft.App.DynamicSessions;
+
+@doc("Code execution file resource collection.")
+model SessionResourceFileCollection {
+  @doc("The files uploaded.")
+  value: SessionResourceFile[];
+}
+
+@doc("Code execution file resource.")
+@resource("files")
+model SessionResourceFile {
+  @key("fileName")
+  @segment("files")
+  @doc("The name of the file.")
+  @visibility("read", "query", "create", "update", "delete")
+  fileName: string;
+
+  @doc("The size of the file.")
+  sizeInBytes: int64;
+
+  @doc("The date time in RFC3339 format when the file was uploaded.")
+  createdAt: utcDateTime;
+
+  @doc("The date time in RFC3339 format when the file was last modified.")
+  lastModifiedAt: utcDateTime;
+}

specification/app/Microsoft.App.DynamicSessions/models/code-execution.tsp

@@ -0,0 +1,96 @@
+import "./common.tsp";
+using Azure.Core;
+using TypeSpec.Http;
+using TypeSpec.Rest;
+
+namespace Microsoft.App.DynamicSessions;
+
+@doc("The request to execute code.")
+model SessionCodeExecutionRequest {
+  @doc("The code input type of the code execution request.")
+  codeInputType: CodeInputType;
+
+  @doc("The execution type of the code execution request.")
+  executionType: ExecutionType;
+
+  @doc("The string of the code to execute, based on CodeInputType.")
+  code: string;
+
+  @doc("Code execution timeout in seconds.")
+  timeoutInSeconds: int64;
+}
+
+@doc("The response containing the result of the code execution.")
+model SessionCodeExecutionResponse {
+  ...SessionCodeExecutionRequest;
+
+  @visibility("read")
+  @doc("Session code execution id.")
+  id: string;
+
+  @doc("The status of the code execution, indicates whether succeeded or not.")
+  status: CodeExecutionStatus;
+
+  @doc("The standard output of the code execution.")
+  stdout: string;
+
+  @doc("The standard error of the code execution.")
+  stderr: string;
+
+  #suppress "@azure-tools/typespec-azure-core/no-unknown" ""
+  @doc("The result of the code execution.")
+  result: unknown;
+
+  @doc("The execution time of the code in milliseconds.")
+  executionTimeInMilliseconds: int64;
+}
+
+@doc("The response of the async code execution.")
+model SessionCodeExecutionAsyncResponse {
+  ...SessionCodeExecutionResponse;
+
+  @header
+  @doc("The async code execution operation id.")
+  operationId: string;
+
+  ...Foundations.LongRunningStatusLocation;
+}
+
+@doc("Code input type.")
+union CodeInputType {
+  string,
+
+  @doc("Inline.")
+  inline: "Inline",
+
+  @doc("InlineBase64.")
+  inlineBase64: "InlineBase64",
+
+  @doc("InlineText.")
+  inlineText: "InlineText",
+}
+
+@doc("Execution Type")
+union ExecutionType {
+  string,
+
+  @doc("Synchronous")
+  synchronous: "Synchronous",
+
+  @doc("Asynchronous")
+  asynchronous: "Asynchronous",
+}
+
+@doc("Code execution status.")
+union CodeExecutionStatus {
+  string,
+
+  @doc("The code execution succeeded.")
+  Success: "Success",
+
+  @doc("The code execution failed.")
+  Failure: "Failure",
+
+  @doc("The code execution canceled.")
+  Canceled: "Canceled",
+}

specification/app/Microsoft.App.DynamicSessions/models/common.tsp

@@ -0,0 +1,36 @@
+import "@azure-tools/typespec-azure-resource-manager";
+
+using Azure.Core;
+using TypeSpec.Http;
+using TypeSpec.Rest;
+
+namespace Microsoft.App.DynamicSessions;
+using OpenAPI;
+
+@doc("The session resource file name parameter.")
+model SessionResourceFileNameParameter {
+  @doc("The name of the file.")
+  @path
+  fileName: string;
+}
+
+@doc("Session identifier query parameter.")
+model SessionIdentifier {
+  @doc("The identifier of the session.")
+  @query
+  identifier: string;
+}
+
+@doc("Session code execution identifier query parameter.")
+model CodeExecutionIdentifier {
+  @doc("The identifier of code execution.")
+  @path
+  executionId: string;
+}
+
+@doc("The session resource file path parameter.")
+model SessionResourceFilePathParameter {
+  @doc("The path of the file after uploaded.")
+  @query
+  path: string;
+}